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Overview 



The Varix Corpcraticn Omni-Programmer product line is a combination of 
hardware and software which is designed to generate the necessary control 
voltages to place data into programmable integrated circuits. The hardware 
manipulates the currents and voltages for the creation of programming 
waveforms and the software controls the sequence of hardware events required 
for chip programming. Since the hardware has no chip dependent circuitry in 
it, it remains unchanged while software configures the socket pins 
appropriately for the targeted programmable device. The software runs on a 
microcomputer and issues commands to the Omni-Programmer hardware via a high 
speed parallel interface. During the programming process, the microcomputer 
must be 100% dedicated to the programming function since much of the 
critical algorithm timing is controlled by instruction timing. When not 
involved in programming, the attached computer is available for data down 
load and up load to larger computers, data printing, or general development 
activities. 

There are two major categories of programmable integrated circuits — read 
only memory (ROM) and programmable logic devices (PLD). ROM's represent the 
larger group and use one of two data storage techniques: fuse link, in 
which a tiny fuse inside the chip is destroyed when data is inserted and 
left intact otherwise; and charge storage, in which a small capacitor on the 
chip is either charged or discharged to represent the binary state of each 
bit. There are four technologies generally used to manufacture programmable 
integrated circuits. They are TTL bipolar, NMOS, CMOS, and ECL. 

TTL bipolar is the oldest of the technologies and uses fuse link techniques 
for storing data. TT1 bipolar' s only advantage is high speed. The chips 
using this technology use a lot of power and are fairly expensive compared 
to MOS. NMOS is the highest density technology, is fairly low power, and is 
inexpensive. Charge storage technology is always used. Up to 512,000 bits 
can be put on a single chip with today's technology. EPROMs and EEPROMs are 
in this group. The greatest disadvantage of NMOS is its low speed. CMOS is 
similar to NMOS but is extremely low power. It uses either charge storage 
or fuse link technology tends to be fairly expensive and ranges from slow to 
fairly fast. The most rapid new developments are in this area. ECL is an 
infrequently used technology reserved for those applications in which 
blazing speed is the only consideration. They are fuse link devices which 
eat power, store only small amounts of data, and are exorbitantly expensive. 
Still, they offer a 10 times speed improvement over other device types. 

While the major use of ROM devices is the permanent storage of data, PLD's 
are oriented toward the control of data flow. The data storage elements in 
a PLD are typically configured in a pattern to replace logic devices in a 
circuit board. Consequently, PLD's are always fuse link devices and are 
generally TTL bipolar technology. There is ongoing development of PLD's in 
CMOS, ECL, and charge storage (EEPLA) devices, but none are currently in 
production. 
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Overview con't. 



Due to the large number of programmable devices available on the market 
Varix has divided them into categories delineated by function and technology 
type. Each of these categories is called a license device group (LDG). 
There are currently 10 LDG's in the Omni product line. 

The Omni-Prcgrammer is designed to program the entire universe of 
programmable devices through software programs. These programs are 
ordinarily supplied by Varix Corporation, but they can be written by the 
user if so desired. Guidance on user written programming algorithms is in 
the user modification section of this manual. There is an occasional device 
whose required voltages are outside the specifications of the Omni- 
Prcgrammer which are detailed in section 3» in which case the device cannot 
be programmed. Varix is committed to providing the software necessary for 
almost all standard production devices in the most timely manner possible. 

This manual provides the information necessary to modify that software, port 
Omni-Prcgrammer to a new microcomputer, and trouble shoot the Omni software 
or hardware if problems should arise. 
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Programmable Devices By Catagory: 

Description 



Varix 
Software 

LDG01 



LDG02 



LDG03 



LDG04- 



LDG05 



LDG06 



LDG07 



LDG08 



LDG09 



LDG10 



EPROMs (UV erasable programmable 
read only memory) most common, 
highest density, low speed 

TTL Bipolar PROMs 

High speed, medium density 

TTL Bipolary PROMs (Current pro- 
grammed) same as LDG02 except 
current is used for programming 
the fuses with data 

Obsolete Devices 
These devices have been discon- 
tinued by the manufacturer for 
new designs 

Microprocessors 

These are really standard Micro- 
processor chips with some EPROM 
or EEPROM on board 

PALs (programmable array logic) 
a small scale, limited PLD 

PLAs (programmable logic arrays) 
General PLDs plus a few special 
application units like program- 
mable multiplexors 

CMOS 



EAROMs (electrically alterable 
read only memory) special byte 
by byte alterable devices 

EEPROMs (electrically erasable 
ROM) can be erased and repro- 
grammed electrically 



Technology 
NMOS 

TTL Bipolar 
TTL Bipolar 

All Types 



NMOS 
CMOS 



TTL Bipolar 
TTL Bipolar 



CMOS 



NMOS 



NMOS 
CMOS 



Storage 
Mechanism 

Charge 
Storage 



Fuse Link 



Fuse Link 



All Types 



Charge 
Storage 



Fuse Link 



Fuse Link 



Charge Storage 
Fuse Link 

Charge 
Storage 



Charge 
Storage 
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Theory of Operations 



Hardware 



The Omni-Programmer is a dumb box whose purpose is to provide 
controlled voltages and currents to the pins of an integrated circuit 
under test. All of the level settings, ramp rates, pulse widths, and 
durations of voltages are controlled in real time by the software in 
the attached microcomputer. 

There are three programmable voltage supplies in the Omni whose 
output voltage can be selectively set by software. Their current limit 
can also be controlled. There are 256 voltage steps and 256 current 
steps for each of the three supplies. The supplies are referred to as 
v1 , v2, and v3. The current being delivered by each supply can be 
measured in steps of 256. -An 8 bit D/A converter is used to adjust the 
voltage + current limit on each supply. Current measurement is 
accomplished by comparing a variable threshhcld voltage against the 
voltage drop of a series resistor in each power supply circuit. In 
addition to the three voltages, any pin can be set to TTL high or TTL 
low. 

The three power supply voltages are multiplexed to various pins on the 
programming sockets and are selectively enabled with transistor 
switches. Each switch is controlled by a bit from an octal latch on 
the Omni logic board. Voltage control bits on the Omni logic board are 
arranged as an array of sixteen 8 bit output ports and six 8 bit input 
ports. Voltage and current D/As, LEDs, and control bits are contained 
in the balance of the I/O ports. In all, 32 I/O ports are assigned to 
an SP0300 Omni-Programmer, 20 for output, 8 for input. 

The interface between the Omni -Programmer and its attached 
microcomputer is designed to allow several configurations so that it 
can be readily adapted through cable wiring to most easily match the 
microcomputer. Basically, there is an 8 bit address, 8 bits of data 
out, 8 bits of data in, control lines, and ground reference in the 
cable. These buses can be run separately, requiring 16 bits of output, 
8 bits of input and only one strobe to indicate when the next data 
transfer should be made. The input data in this mode will 
asynchronously represent the data from the input pert selected by the 
address bus. At the other extreme, the entire bus may be multiplexed 
on 8 data lines. In this case, an address strobe is used to indicate 
valid address on the bus, a data strobe is used to indicate valid data, 
and an input strobe is used to turn the bus around for reading. Both 
the address and data are latched by the Omni in this configuration. 
NOTE: due to the high data transfer rates required for real time 
manipulations of voltages on pins, it is impractical to use any kind of 
serial interface scheme. The required transfer rate exceeds 1 Mbaud. 
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Software 



The software for the Omni-Programmer runs exclusively on the attached 
microcomputer. With the exception of critical timing code, it is 
written in the high level language "C" to promote portability from one 
microcomputer to another. The software is divided into three sections: 

One: the hardware interface is 1000 bytes of assembly 
language code which communicates between the 
microcomputer/Omni hardware and the software. Only this 
section is modified when porting Omni from one microcomputer 
to another so long as both are using the same microprocessor 
and operating system. 

Two, the programming algorithm is 4-000 bytes of "C" and 
assembler which creates the wavefrcms and controls the 
programming algorithm for the device being programmed. 

Three, the user interface is 52,000 bytes of "C" code which 
generates the displays, accepts and executes user commands, 
and handles all system functions. 

Both the hardware interface and programming algorithm software can be 
modified by the user. Techniques for doing this are described in the 
user modification section. Communications between the various modules 
is achieved through fixed jump vectors and status words in each module. 
This allows each module to operate entirely on its own and offers no 
restrictions on what language the module is written in so long as it 
adheres to the fixed interface specifications. 

In addition to the actual programming code, there are a group of 
special utilities which enhance the programming environment. Omni comm 
supports communications between the microcomputer and a host machine so 
that chip data can be received from a remote source. Monolithic 
Memory's PALASM allows the creation of programmable logic device 
patterns from Boolean logic equations. Statistics prints historical 
information on Omni programming activity. BW offers diagnostic testing 
on the hardware. 

One of the major advantages of the Varix Omni-Prcgrammer is the 
flexibility it gives the user in writing software — either as 
utilities, or as part of the programming environment, to manage the 
programming process for maximum efficiency. 
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Specifications 



Hardware Interface Specifications 



The I/O port is sent via the address bus from the microcomputer. The 
data on the data bus is used to select bits within the I/O port. The 
output ports are divided into primary, secondary, and auxiliary ports. 
The primary ports are assigned one bit per socket pin where that bit 
indicates a reset condition (zero volts) when low ("0") and some 
positive voltage when high ("1"). The secondary ports control which 
voltage is active when a primary port bit is high. In the absence of a 
secondary port for a particular pin, the high state creates a logic 
level "1" on the socket through a 10K pull-up resistor to 5v. This 10K 
resistor also provides the pull-up for open collector output devices. 
The state in which the 10K resistor to 5v is active is called the 
"disable" condition. Any output pin from a chip should be "disabled" 
prior to reading data for it. 

The secondary ports assign either one or two bits to a socket pin 
depending on how many voltages are available for that pin. In the case 
of a single secondary bit, a "0" indicates disable condition and "1" 
selects a voltage (typically v2) . In the two bit decode case, 00 is 
disable, 01 is v1 , 10 is v2, and 11 is either v3 or elk. The elk is a 
3MHz driven square wave for use on microprocessor chips. 

The auxiliary ports are D/A data, LED control, and calibration logic 
control. The read ports read the state (0 or 1) of each pin as 
compared to the threshold voltage. Consequently, the actual voltage 
on a pin can be determined with .118 volts by adjusting the threshold 
voltage until a transition occurs on the relevant pin. 
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Write Ports (primary) 
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Write Ports (secondary) 
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Write Ports 

I/O Port Bits 
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Read Ports 
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I/O Port Bit 
5 0 
1 
2 
3 

5 
6 
7 



6 NOT USED 

7 NOT USED 

8 NOT USED 

9 NOT USED 
A NOT USED 
B NOT USED 
C NOT USED 
D 0-7 

E NOT USED 

F 0 
1 
2 



03/01/84 



Interfact Specf ications con't. 

Read Ports con't. 

48 28 24 

Pin Pin Pin 

45 

46 

47 

48 3 24 

1 
2 
3 
4 



Reads Programmed Threshold Set 

v1 Current Sense 
v2 Current Sense 
v3 Current Sense 

Omni-Programmer Technical Manual Release 1 .0 

12 



Specifications 



Hardware Interface Specifications con't. 



Chip Map 



The table on the following page shows the relationship between 
the pins on the 4-8 pin socket and the pins on the other two 
sockets. The voltages available on those pins are also shown. 

The first four columns contain pin numbers for socket #1 (6/10")« 
The first column relates to a 4-8 pin device, the second column 
corresponds to what a 4-0 pin device orientation would be in the 
same socket. The next three columns are the assignments that are 
hardware set for the pins specified. All pin # parameters are 
specified relative to the 48 pin socket. 
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15 


16 


17 


27 


v1 
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v2 


v1 


23 


13 


12 


11 


10 


13 


14 


15 


16 


26 


v1 


v2 






gnd 


24 


14 


13 


12 


11 


12 


13 


14 


15 


25 


v1 


v2 


v3 





v2 


33 


1 




v2 


v1 


13 


2 




v2 


v1 


29 


3 


1 




v2 


U 


4 


2 




v2 


15 


5 


3 




v2 


16 


6 


4 




v2 


17 


7 


5 


v2 


v1 


30 


8 


6 


v2 


v1 


19 


9 


7 


v2 


v1 


20 


10 


8 


v3 v2 


v1 


25 


11 


9 




gnd 24 


12 
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20 



1 






18 


19 


2 


1 


16 


17 


18 


3 


2 


15 


16 


17 


4 


3 


14 


15 


16 


5 


4 


13 


14 


15 


6 


5 


12 


13 


U 


7 


6 


11 


12 


13 


8 


7 


10 


11 


12 


9 


8 


9 


10 


11 



24 


48 


v3 






23 


31 


v2 






22 


36 




v2 


v3 


21 


44 




v2 


v3 


20 


11 


V1/1 


.5 


v2 


19 


27 


v1 


v2 




18 


18 


v2 






17 


26 


v1 


v2 




16 


23 


v1 


v2 




15 


23 


v1 


v2 


elk 


U 


21 


v1 


v2 




13 


22 


v1 


v2 
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CHIPMAP 



4.8- 


40- 


28- 


24- 


Pri- 


1st 


2nd 


28- 


24- 


pin 


pin 


pin 


pin 


mary 


Alt 


Alt 


pin 


pi] 


1 

2 


















3 


















4 


















5 


1 
















6 


2 






CLK 










7 


3 






CLK 










8 


4 
















9 


5 






V2 










10 


6 
















11 


7 


1 




V1 


V2 


V3 


22 




12 


8 


2 




V2 






23 




13 


9 


3 


1 


V1 
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24 


2 


U 


10 


4 


2 


V2 






4 


4 


15 


11 


5 


3 


V2 






5 


5 


16 


12 


6 


4 


V2 






6 


6 


17 


13 


7 


5 


V2 






7 


7 


18 


14 


8 


6 


V2 






8 


18 


19 


15 


9 


7 


V1 


V2 




9 


9 


20 


16 


10 


8 


V1 


V2 




10 


10 


21 


17 


11 


9 


V1 


V2 




11 


U 


22 


18 


12 


10 


V1 


V2 




12 


13 


23 


19 


13 


11 


V1 


V2 


CLK 


13 


15 


24 


20 


U 


12 


GND 






14 


12 



COMMENTS 



3-MHZ 
3-MHZ 



3-MHZ 



25 


21 


15 


13 


V1 


V2 


V3 


15 


11 


26 


22 


16 


14 


V1 


V2 




16 


17 


27 


23 


17 


15 


V1 


V2 




17 


19 


28 


24 


18 


16 


V1 


V2 




18 


16 


29 


25 


19 


17 


V1 


V2 




19 


3 


30 


26 


20 


18 


V1 


V2 




20 


8 


31 


27 


21 


19 


V2 






21 


23 


32 


28 


22 


20 


V2 






26 




33 


29 


23 


21 


V1 


V2 


-5V 


27 


1 


34 


30 


24 


22 


Y2 






28 




35 


31 


25 


23 


V2 










36 


32 


26 


24 




V2 


V3 


25 


22 


37 


33 


27 




V2 










38 


34 


28 




V3 






1 




39 


35 
















40 


36 
















41 


37 
















42 


38 
















43 


39 
















44 


40 








V2 


V3 


2 
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45 
46 
47 

48 V3 3 24 



15 



FUWAP 



pin reset disable set altl alt2 

1 port 5 bit 4 0 port 5 bit 4 1 



2 


port 5 bit 5 


0 


port 5 bit 5 


1 












3 


port 5 bit 6 


0 


port 5 bit 6 


1 












4 


port 5 bit 7 


0 


port 5 bit 7 


1 












5 


port 3 bit 0 


0 


port 3 bit 0 


1 












6 


port 3 bit 1 


0 


port 3 bit 1 
port 8 bit 0 


1 
0 


port 3 bit 1 
port 8 bit 0 
elk 


1 
1 








7 


port 3 bit 2 


0 


port 3 bit 2 
port 8 bit 1 


1 

0 


port 3 bit 2 
port 8 bit 1 
elk 


1 
1 








8 


port 3 bit 3 


0 


port 3 bit 3 


1 












9 


port 3 bit 4 


0 


port 3 bit 4 
port 8 bit 2 


1 

0 


port 3 bit 4 
port 8 bit 2 
v2 


1 
1 








10 


port 3 bit 5 


0 


port 3 bit 5 


1 












11 


port 4 bit 5 


0 


port 4 bit 5 
port C bit 1 
port l> bit U 


1 

0 
u 


port 4 bit $ 
port C bit 1 
port 0 bit 0 
vl/1.5 


1 

0 

i 


port 4 bit 5 
port C bit 1 
port 0 bit 0 
v2 


1 
1 

0 


port 4 bit 5 1 
port C bit 1 1 
port 0 bit 0 1 
v3 


12 


port 2 bit 4 


0 


port 2 bit 4 
port 9 bit 7 


1 

0 


port 2 bit 4 
port 9 bit 7 
v2 


1 
1 








13 


port 1 bit 7 


0 


port 1 bit 7 
port D bit 7 
port D bit 6 


1 

0 
0 


port 1 bit 7 
port D bit 7 
port D bit 6 
v1 


1 
0 

1 


port 1 bit 7 
port D bit 7 
port D bit 6 
v2 


1 
1 

0 





pin 


reset 




disable 




sex 




altl 




alt2 


14 


port 1 bit b 


u 


port \ bit 0 
port 9 bit 5 


-i 
1 

0 


port 1 bit 6 
port 9 bit 5 
v2 


1 








1 £ 


port 1 Dit 0 


U 


port l bit 5 
port 9 bit 4 


1 

0 


port i bit 0 
port 9 bit 4 
v2 


I 

1 








ID 


port 1 bit 4 


u 


port 1 bit 4 
port 9 bit 3 


1 
0 


port 1 bit 4 
port 9 bit 3 
v2 


1 
1 








1 7 


port 1 bit 3 


0 


port 1 bit 3 
port 9 bit 2 


1 

0 


port 1 bit 3 
port 9 bit 2 
v2 


1 
1 








1o 


port 1 bit < 


U 


port 1 bit d 
port 9 bit 1 


1 

0 


port 1 bit <Z 
port 9 bit 1 
v2 


1 
1 








19 


port 1 bit 1 


0 


port 1 bit 1 
port 0 bit p 
port C bit 4 


1 

u 
0 


port 1 bit 1 
port u bit p 
port C bit 4 
v1 


1 
U 
1 


port 1 bit 1 
port u bit o 
port C bit 4 
v2 


1 
I 

0 




20 


port 1 bit 0 


0 


port 1 bit 0 
port L- bit j) 
port C bit 2 


1 

U 

0 


port 1 bit 0 
port u bit J 
port C bit 2 
v1 


1 
U 
1 


port 1 bit 0 
port u bit 3 
port C bit 2 
v2 


1 

l 

0 




21 


port 0 bit 0 


0 


port 0 bit 0 
port A bit < 
port A bit 0 


1 

U 

0 


port 0 bit 0 
port A bit 1 
port A bit 0 
v1 


1 
U 
1 


port 0 bit 0 
port A bit 1 
port A bit 0 
v2 


1 

1 

0 




22 


port 0 bit 1 


0 


port 0 bit 1 

____4_ A !• 4- O 

port A bit j> 
port A bit 2 


1 

U 

0 


port 0 bit 1 
port A bit j> 
port A bit 2 
v1 


1 
U 
1 


pert 0 bit 1 
port A bit j> 
port A bit 2 
v2 


1 

-1 

1 

0 




23 


port 0 bit 2 


0 


port 0 bit 2 
port A bit 5 
port A bit 4 


1 
0 
0 


port 0 bit 2 
port A bit 5 
port A bit 4 
v1 


1 

0 
1 


port 0 bit 2 
port A bit 5 
port A bit 4 
v2 


1 
1 

0 


port 0 bit 2 1 
port A bit 5 1 
port A bit 4 1 
elk 



pin reset disable set altl alt2 



24 


port 3 bit 7 
ground 


X 
















25 


port 0 bit 3 


0 


port 0 bit 3 
port A bit 7 
port A bit 6 


1 

0 
0 


port 0 bit 3 
port A bit 7 
port A bit 6 
v1 


1 
0 
1 


port 0 bit 3 
port A bit 7 
port A bit 6 
v2 


1 
1 

0 


port 0 bit 3 1 
port A bit 7 1 
port A bit 6 1 
v3 


26 


port 0 bit 4- 


0 


port 0 bit 4- 
port B bit 1 
port B bit 0 


1 

0 
0 


port 0 bit 4- 
port B bit 1 
port B bit 0 
v1 


1 
0 

1 


port 0 bit 4- 
port B bit 1 
port B bit 0 
v2 


1 

1 
0 




27 


port 0 bit 5 


0 


port 0 bit 5 
port B bit 3 
port B bit 2 


1 

0 
0 


port 0 bit 5 
port B bit 3 
port B bit 2 
v1 


1 

0 

1 


port 0 bit 5 
port B bit 3 
port B bit 2 
v2 


1 
1 

0 




28 


port 0 bit 6 


0 


port 0 bit 6 
port B bit 5 
port B bit 4- 


1 

0 
0 


port 0 bit 6 
port B bit 5 
port B bit 4- 
v1 


1 

0 

1 


port 0 bit 6 
port B bit 5 
port B bit 4- 
v2 


1 
1 

0 




29 


port 0 bit 7 


0 


port 0 bit 7 
port B bit 7 
port B bit 6 


1 

0 
0 


port 0 bit 7 
pert B bit 7 
port B bit 6 
v1 


1 

0 

1 


port 0 bit 7 
port B bit 7 
port B bit 6 
v2 


1 
1 

0 




30 


port 2 bit 7 


0 


port 2 bit 7 
port C bit 7 
port C bit 6 


1 

0 
0 


port 2 bit 7 
port C bit 7 
port C bit 6 
v1 


1 

0 

1 


port 2 bit 7 
port C bit 7 
port C bit 6 
v2 


1 
1 

0 





31 port 2 bit 2 0 port 2 bit 2 1 port 2 bit 2 1 

port 9 bit 0 0 port 9 bit 0 1 

v2 



32 port 4- bit 7 0 port 4 bit 7 1 port 4. bit 7 1 

port 8 bit 4 0 port 8 bit 4- 1 

v2 



pin 


reset 




disable 




set 




altl 




alt2 




33 


port 2 bit 3 


0 


port 2 bit 3 
port D bit 1 
port D bit 0 


1 

0 
0 


port 2 bit 3 
port D bit 1 
port D bit 0 
v1 


1 
0 
1 


port 2 bit 3 
port D bit 1 
port D bit 0 
v2 


1 
1 
0 


port 2 bit 3 
port D bit 1 
port D bit 0 
-5 


1 
1 
1 


34 


port 2 bit 1 


0 


port 2 bit 1 
port 9 bit 6 


1 
o 


port 2 bit 1 
port 9 bit 6 
v2 


1 
1 










35 


port 2 bit 0 


0 


port 2 bit 0 
port 8 bit 3 


1 

0 


port 2 bit 0 
port 8 bit 3 
v2 


1 
1 










36 


port 2 bit 5 


0 


port 2 bit 5 
port D bit 3 
port D bit 2 


1 

0 
0 






port 2 bit 5 
port D bit 3 
port D bit 2 
v2 


1 
1 
0 


port 2 bit 5 
port D bit 3 
port D bit 2 
v3 


1 
1 
1 


37 


port 2 bit 6 


0 


port 2 bit 6 
port 8 bit 5 


1 

0 


port 2 bit 6 
port 8 bit 5 
v2 


1 
1 










38 


port 4 bit 6 


0 


port 4 bit 6 
port 8 bit 6 


1 

0 


port 4- bit 6 
port 8 bit 6 
v3 


1 
1 










39 


port 4 bit 4 


0 


port 4 bit 4 


1 














40 


port 4 bit 3 


0 


port 4 bit 3 


1 














41 


port 4 bit 2 


0 


port 4 bit 2 


1 














42 


port 4 bit 1 


0 


port 4 bit 1 


1 














43 


port 4 bit 0 


0 


port 4 bit 0 


1 














44 


port 3 bit 6 


0 


port 3 bit 6 
port D bit 5 
port D bit 4- 


1 

0 
0 






port 3 bit 6 

port D bit 5 

port D bit 4 
v2 


1 
1 

0 


port 3 bit 6 

port D bit 5 

port D bit 4 
v3 


1 
1 
1 



g pin reset disable set ■ altl al t2 



o 



00 



D 
H* 
I 

~D 
H 
O 
CD 

03 
3 
3 
CD 

— I 
CD 
O 

zr 

D 
H« 

O 



0) 
D 
C 
03 



X> 
CD 
I — 1 
CD 
0> 
CO 
CD 



O 



45 


port 5 bit 0 


0 


port 5 bit 0 


1 




46 


port 5 bit 1 


0 


port 5 bit 1 


1 




47 


port 5 bit 2 


0 


port 5 bit 2 


1 




48 


port 5 bit 3 


0 


port 5 bit 3 


1 


port 5 bit 3 1 



port 8 bit 7 0 port 8 bit 7 1 

v3 



Specifications con't. 



Hardware Interface Specifications 



Interface 



ram 



max 



units 



Strobe pulse widths (address, data) 
Data in stable 
Data setup time 
Data hold time 

Delay from data into output strobe 



100 
• 3 

100 
10 

100 



nanoseconds 

microseconds 

nanoseconds 

nanoseconds 

nanoseconds 
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Software Interface Specification 



Under the OMNI operating system, memory is allocated as follows: 

0103H thru 0502H Hardware Control Code (HCC) 

0503H thru 1602H Programming Algorithm (PA)/ 

User Defined PA (UDP) 

1603H thru FFFFH OMNI Operating System (OS) 

The Programming Algorithm is the software that is normally 
loaded to program or read a desired device such as a 2716 EPROM. 
It consists of a series of instructions that jump to various 
address pointers in the HCC which in turn carry out hardware set-up 
and execution operations like "set pin 11 to voltage 1". These 
addresses are called Function Pointers. They are described in the 
following paragraphs using this format: Address in hex, Function name, 
functional description, and where applicable, range and typical default 
condition for a 2716 EPROM. When a jump to a function is performed the 
stack must contain appropriate information for the function: the 
proper sequence would be first the function pointer address, then the 
function parameter (s) (abbreviated "param #"). 

0103H resall 

Reset all pins to initializationn state. This function causes all 
pins to be reset. 

0106H disall 

Disable all pins; with pins in this state they can neither be written 
to nor read. 
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Software Interface Specification con't. 



0109H respin 

Resets the pin number in Param 1: range of pins 1-4.8. Reset sets 
the pin to 0 volts. 

010CH dispin 

Disables the pin number in Param 1; range of pins 1-4-8. Disabling a 
pin sets the pin voltage to 5 volts through a 10 Kohm pullup resistor. 

010FH setpin 

This function sets the pin number in Param 1 to its primary voltage or 
clock assignment; range of pins 1-4.8. Pin assignments can be found 
in the CHIPMAP found at the end of this section. 

0112H altlpin 

This function sets the pin number in Param 1 to its first alternate 
voltage or clock assignment; range of pins 1-4-8 (not all pins have 
alternate conditions). Pin assignments can be found in the CHIPMAP. 

0115H alt2pin 

This function sets the pin number in Param 1 to its second alternate 
voltage or clock assignment; range of pins 1-4-8 (not all pins have 
alternate conditions). Pin assignments can be found in the CHIPMAP. 

0127H rdpin 

Reads the pin number in Param 1 ; range of pins 1 -4-8 . A read must be 
preceeded by a disable to the disired pin or the read will return what 
the pin has been set to. 

012AH setvl 

This function sets the primary voltage, referenced above, to the 
voltage determined by : .118 volts multiplied by (X) the value in 
Param 1; range of Param 1 = 0 to 255, range of voltage value=0 to 28 
volts. Default value for a 2716 is Param 1 = 226 ( 27 volts); this 
value is usually not changed while programming the 2716. 
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Software Interface Specifications ccn't. 



012DH setv2 

This function works just like setvl does. Its value may change 
many times while programming a 2716 depending on the other 
functions it is being used with. It is the first alternate 
voltage. 

0130H setv3 

This function works just like setvl and setv2 do. It is used 
like setv2 while programming but may not be changed as much 
because it is not available on many pins (see CHIPMAP). It is 
the second alternate voltage. When using the alt2pin function 
on pin 33 this voltage sets pin 33 to -5 volts for use with the 
AMD part number 27S27 . 

0133H setcvl 

This function sets the current limit for the primary voltage, v1 , 
to the current determined by .004 amperes X the value in Param 1; 
range of Param 1 = 0-255; range of current =0-1000 milliamperes. 
The default condition for the 2716 is Param 1=255. 

0136H Setv2 

This function works just like setcvl for the first alternate 
voltage but it limits the current to 255 milliamperes and each 
increment has a value of .001 amperes; range of Param = 0 - 255; 
range of current = 0 - 255 milliamperes. The default condition 
for a 2716 is Param 1 =255. 

0139H setthr 

This function sets the threshold voltage which is used while 
reading a pin to determine a high or low state. It's value is 
set just like setvl where each increment represents .118 volts; 
range of Param 1=0- 255; range of voltage = 0 — 28 volts. 

0K5H connect 

This function is used only to see if the OMNI Programming Unit is 
attached to the Kaypro or other controlling processor. When this 
function is called a routine is started that either returns an 
error message or returns to the control program if no connect 
problems are detected. 
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OUBH delay 

This function creates a delay equal to the value of Param 1 X 100 
microseconds. Range of Param 1 is 0-255; range of delay is 0 to 
25500 microseconds. This function is used to control the amount 
of time a programming voltage is applied to a particular pin. 

The code that becomes the UDP replaces the standard Programming 
Algorithm and therefore becomes the interface between the 
Operating System and the device for which the UDP is being 
written. Thus, some precautions are necessary to ensure no harm 
is done to the device and that the desired functions can be 
performed by the user. Within the section of memory known as the 
UDP, there are some pre-assigned locations that must be left 
untouched for the operating system to access them properly. The 
UDP can be looked at as having three sections as follows: 

0503H thru 051 2H Setup Conditions 

051 3H thru 051 FH Device Type Definition 

0520H thru 0520H User Written Program Algorithm 

The setup conditions are spaces in memory that set up the device 
for initialization, reading, writing, error reporting and 
configuration as follows: 

0503H devsetup (chip index) 

0506H devread (chip start address, memory start address, 
count) 

0509H devwrite (chip start address, memory start address, 
count) 

050CH error condition cede reporting 
050EH error condition address 

The jumps to these addresses are done by the OS; they are 
filled by the OS from inputs to prompt the user answers on 
initialization. The parameters will be loaded onto the stack in 
the order listed (paraml , param2, param3). 
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Software Interface Specifications con't. 



The next three bytes are also filled by the OS. 

051 OH number of pinns on device (24 for 27U) 

0511H socket used for this device (1=6/10", 2=4/10", 3=3/10") 

051 2H device type (1=PR0M, 2=PLA, 3=PGA, 4=PAL) 

The section that begins with 051 3H varies in length and interpre- 
tation by device type. For PROMs and addresses contain the 
following information: 

051 3H promlen Max number of words to be addressed (for 2716-204-8) 
051 5H promwid Word length (2716 word length = 8 bits) 
0517H prcmblk Initial state of bits (0FFH for 2716) 

For FPLAs the addresses contain the following information: 

Number of P-terms possible 
Number of input bits possible 
Number of output bits possible 
Blank state of output bias 
Blank state of AND matrix 
Blank state of OR matrix 
Starting input number 
Starting output number 



0513H 


plalenn 


051 5H 


plaiwid 


051 6H 


placwid 


051 7H 


plabias 


051 8H 


plaand 


051 9H 


placr 


051 AH 


plai start 


051 BH 


plaostart 


PALs the 


addresses 


0513H 


palinp 


05 UH 


palprcd 


051 5H 


palbln 


051 6H 


palilst 


051 7H 


palpi st 


051 8H 


palblst 



Number of PAL inputs 
Number of PAL products 
Number of blown links 
Pointer to bit array of inputs 
Pointer to bit array of products 
Coordinate array of blown links 

For FPGA (Field Programmable Gate Arrays) the addresses contain 
the following information: 

051 3H pgalen PGA length 
051 5H pgawid PGA width 
051x tbd to be defined 
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Voltage Supply Circuits: 





min 


max 


units 


Output voltage range 


0 


30 


volts 


Max output voltage 


28 


30 


volts 


Voltage steps 


.118 




volts / steps 


Current limit (vl) 


0 


1 .02 


amps 


(v2) 


0 


255 


mA 


(v3) 




1.2 


amps 


Current limit steps (v1 ) 




4- 


mA/ step 


(v2) 




1 


mA/step 


Current step error 




5% 




Slew rate (v1 ) 


.2 


.3 


v/microsecond 


(v2) 


.4 


.5 


v/microsecond 


(v3) 


.2 


.3 


v/microsecond 


Current sense (v1 , v3) 


0 


1.2 


amps 


(v2) 


0 


250 


mA 


Socket pin switches: 








Current on v2 switches 


0 


.5 


amp 


Current on vl , v3 switches 


0 


3 


amps 


Saturation voltage change v1 , v3 
(minimum current to max current) v2 

GND 


.2 

= 2 
.1 


.4. 
.3 
.3 


volts 
volts 
volts 


Current limit on gnd switch 


6 


15 


mA 


Slew rate 
-5v circuit current 


20 


40 
-100 


v/microsecond 
mA 
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Electrical Specifications con't. 
Voltage Calibration Circuit 



Reference voltage 
Threshold voltage 
Threshold voltage error 
Threshold voltage steps 



ram 



max 



units 



9.95 

0 



10.05 
30.1 
.1% 
.118 



volts 
volts 

volts/step 
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Overall Dimensions 
Table space required 
Weight 

Operating Environment: 
Temperature 

Humidity- 
Voltage 

Power Requirements 



Mechanical Specifications 

16" W x 11" D x 5" H 
16" W x U« D 
8 lbs. 

32 - 95 c F 
0-35° C 

20%-80% relative 

110VAC + 10% 

50 watts 
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User Specified Programming Algorithms 



The Omni-Programmer algorithm area is ordinarily used for loading the software 
algorithm used to program a particular group of chips. The Omni user interface 
and operating system uses the index file OMNI.IDX to find the program which 
should be loaded into the available algorithm space. The available space is 
only 4-000 bytes so any user program must be no larger than that. 

The user algorithm can be written in any language. It must adhere to the 
software interfaces specified in the previous section, be absolute binary Z80 
machine code targeted for a bottom address of 503 (Hexadecimal), and reside in a 
file with the first byte of the file being the first byte of the program. If 
the filename is then placed appropriately in OMNI.IDX, the user algorithm will 
execute when called. 

Varix programming algorithms are all written in the high level language "C" . In 
order to improve the speed of programming, the innermost loops have often been 
replaced with assembly language assist routines. Functions like incrementing to 
the next chip address and assembling the data output into a single word are 
examples of these situations. 

There are two basic approaches to writing device algorithms used by Varix 
Corporation. The first uses calls to the hardware interface routines described 
in the previous section to set each pin on the chip in the desired manner. 
EXAMPLE: Placing a 10 bit address on the address bus of a PROM requires a 
sequence of 10 calls to either DISPIN or RESPIN dependent on whether the pin is 
TTL high or TTL low. While the resulting code is very straight forward, it is 
also somewhat slow. 

The second approach involves a combination of high level code and tables which 
describe the chip. In the above example with a 10 bit address, a table would be 
created which listed the chip pins making up the address bus. A single call to 
MAPW0RD would then cause the data pattern to be placed on the appropriate pins. 

Once the code and tables are created, the following system sequence should be 
used to create the programming algorithm. 

A>cii -m -X300 b: <f ilename> .c 

A>m80 =b:<filename> .asm 

A>180 /p:503, hprom, b:<filename>, cmnilib/s, libc/s, b: <filename>/n/x/e 

A>zsid 

*i<f ilename> . hex 

*r-403 

*Ac 

A> SAVE 16 B:<filename>.000 
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User Specified Programming Algorithms con't. 



The link process (L80) will complete with a message in the following format: 

[0 503 U39] 

if the third number exceeds 1503, your programming algorithm is too large and 
must be reduced in size. 

M80 and L80 are the Z80/8080 macro assembler and linker from Microsoft, Inc. 
CII is the 'Aztec C Compiler from Manx Software Systems, Inc. ZSID is the 
symbolic debugger from Digital Research, Inc. 

Due to the stand alone nature of the programming algorithm module, it is 
possible to use any compiler, assembler, linker so long as the interface 
specifications are adhered to. A development package can be purchased from 
Varix which contains the development software customarily used by Varix along 
with command files. 

Once the algorithm is written, it must be listed in the OMNI.IDX file in order 
to be invoked. The format of the file is shown on the following page. 
Typically, only the filename with a pound sign in front followed by the name 
(such as chip device number) with which you wish to invoke the file. The name 
must be preceded by a zero, which is ordinarily used as an index into a 
programming algorithm which may program several chips. EXAMPLE: To invoke the 
file CALIB.000 by typing CALIBRATE under the Omni -Programmer software add the 
following entries to OMNI.IDX: 

#CALIB.000 

OCALIBRATE ; Special note: all invocation names must use upper case 

letters. 

The entire OMNI.IDX file locks like: 



(see following page) 
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Omni-Prcgrammer Index File 



10/5/83 



; Special characters are: 

; # Family name (general device type) 

; @ User interface filename 

; % Command table filename 

; : Personality module filename 

; ; Comment line (blank lines are comments also) 

; A personality name is preceeded by the index (in hex) of its module 
; in the personality file. 

; Proms 

#EPR0M 
©0MPR0M.0VR 
%0MPR0M.TBL 
:0MEPRM.000 

02516 12532 42564 02716 22732 32732A 52764 

:0MEPRM.001 

027128 127256 

:0MEPRM.002 

068732-0 

168732-1 

268764 268766 

; Gang-programmer Proms 

#GANG 

©0MGANG.0VR 
%0MGANG . TBL 

:0MGPRM.000 

02716 12732 22732A 

:0MGPRM.001 

02764 127128 227256 
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User Specified Programming Algorithms ccn't. 



It is valuable to note that the OMNI.IDX file can be modified by using any 




User Modifications 



USER SPECIFIED ALGORITHMS 
User specified algorithms METHOD I: 

(see following pages) 
TEPR0M1.C 
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User Modifications METHOD I Example: 

* include "a: t d i o . h" 

i! i nc: 1 u "a : ^oo n f i y . h" 

/* 
*/ 
/* 
*/ 

* :i. n c 1 u d s " a : d n h d w . h " 

/* 

s e t Li p v a v j a b 1 a t t:i h o 1 d p in number s 

*/ 



o r a d u <.:• t i dm u e r s :* n n 



Setup the function painters for the hardware interface routiner. 



i n t 


e« ; 


int 


ao ; 


i nt 


upp ; 


int 


pgn ; 


i n t 


p d p q m ; 


i i! t 


; >np(|B» ; 


•i nt 


aevpp ; 


int 


esl ; 


.i. i i I 


cs;2; 


int 


wee ; 


i n t 


wee a ; 


/*■ 






address; 


*/ 




:i. i i t 


maxaddr 



ft ma; i mum address pin number %I 

1% 251.6/2 716 add res S3 pins */ 

char amaplCilJI €20 , 19, IB, 17, 16, 15, 1/1, 13, 35, 3-1, 31}; 

/# 2532 address pins */ 

char a»ap2C123 €20 , 19, 18 , 17, 1.6, IS, 14. 13, 35, 3'1, 31, 30) ; 

/* 2732 /2732a address pine */ 

char aiflap3i::i2'.3 ■ CEO . 19, 18, 17, 16, 15, 11, 13, 35 , 3-1, 31 , 33); 

it 256 4 address pins */ 

char anap4Ci3:J - €20 , 19, 18, 17. 16, 15, 1*1. 13, 35, 3-1, 31, 30, 33); 

it 2764 address pins #/ 

char anap-jr.133 - €.20 , 19, 18, 17, 16. 15, 14, 13, 35, 31, 31, 33, 12) ; 

char* tfadrtabj 

/:* 

define uoltaqes needed by the eproms 
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#..l*?i n*. 


UCC 


46 




/* 5 02 volts */ 


a* *. ■ T t 1 1 *: : 


vin 


•'J / 




/ ,.! . , > L. \t (.1 1. 1. !.J / 


*defin« 


MP PI 


a i :i. 




/* a.:> . 32 volt* */ 


fdef i ne 


<;PP2 


1.79 




/* ?.: .. 10 units */ 


*def in« 


THRESH 


17 




1% 2. OA volts #/ 


Idef inc 


CHPCHK 


2l, 




/* S. 93 waits */ 


#def in« 




2 Jib 




/# maximum currant, limit #/ 


tde-f a. no 




a:>:> 




/* maximum current, limit */ 


i n t 


V C C V J 








i u t 


vihul. ; 








:i. n o 


v/ihv/2; 








int 


v p p J. \/ X ; 








i. n t 


v p p i v 2 ; 








i rt t 


■jpp2vl ; 








i n t 


vpp2i;2 ; 








d i"; f 3. 11 e 


ti t 








ttdef ine 


ua 


a 






ids fine? 


03 


a 






/* 












de " i rie 


the 


r U f i r.i. 11 d 


reset buttons 


*/ 










idef :i. ne 


RNBUTTON 


12 


/ * r ti n b u 1 1 c> ri * / 



tfdefine U5BUTT0N A3 ft reset- button */ 





def i lie 


1 1 i e p r o q r a m w i n q i n t e r u a 3. a 




*/ 








*def i ne 


TPi 


3 / & .3 m i 1 1 i s e. c a n d s 


*/ 


$ define 


I pa 


9 /* .9 milliseconds 


*:/ 


♦define 


TP "3 


36 /* 3.6 milliseconds 


%l 


•tde f ine 




bOO . /* :>0 . 0 mi Lii seconds 




/* 










S S i, up 


led bits 




*/ 








*def i lie 


tiNECT 


0x03 




■i-def ine 


PilBllAM 


0x20 




*t]«f ine 


PGERR 


0 x 1 0 




•ilde f i tie! 


SKT3 


0x01 




tdef i nm 


5KT2 


0x02 




■s define 


SKT1 


0x0 X 




/* 










temporary variable!:. Far cade optimization 




* / 








i. ii 1 




• NO; 1% successful deusetup flag 
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1 ci t 


r t oeode ; 


/* 


F i.i n c t i !;i n r e t 1 1 r n c o d e 


#/ 


i n t 


a t a t u a ; 


/# 


pi a pin a t a t, u s t e m p 


*/ 


i i i t 


address ; 


/* 


chip address 


*/ 


int 


o \ daddr ; 


/*: 


last address accessed 


*/ 


i i t t 


t«H»paddr j 


/* 


t e in p !:i r a r y a d d r e a a 


*/ 


int 


i nde.< ; 


/* 


f ci r I a o p 1 rt d o x 


*/ 


i n t 


got data ; 


/* 


•j, (imp For verify 


«/ 


int 


data : 


/* 


data byte 


#/ 


c hair 


*buf f«r ; 


/* 


p a i n t £ r i n t o d a t ;:). b u f f r 


%l 


int 


saddr ; 


f* 


temp fnr ad dr parameter 


*/ 


char 


$&&uxhuf , 


/* 


temp for auxbuf parameter 


#/ 




a Illicit It ; 




temp far length parameter 


*/ 


i in 


a t p ; 


/* 


current prop ramming interval. 


*/ 


int 


er ra ; 


/* 


errur programming far 1 «s?c 


*/ 


i n t 


ii r r b ; 


/* 


error programming For 3 msec 


#/ 


j. \\ t 


tdevubr :: 0 ; 


/* 


t e m p for •: ! e v i r e 1 1 u m b e r in d e x 


*/ 


:i. ii t 


mas k ; 


/* 


address bit mask 


#/ 


i nt 


(*dfJ (); 


/# 


pai nter to d e v r e a d f u n c t i u n 


51?/ 


i 


Udu) (J; 


/* 


pointer to dew write Function 


*/ 


1 1! 1 


(*|)u) (); 


/* 


pointer to prngverf function 


*/ 


i n t 


(*e:d ) ( I ; 


/* 


P o i n t e r t ci c h e c i< d a t a f u net . 


*/ 


/* 











*/ 



set up pointer' to device error number and configuration table 



:i. n t % tl ewer r o r 0 x 'i 0 c ; 

i i i t t e r r a d d r s • : 0 :< 5 0 e ; 

OHO KM- IG *eonfit| « OvIUO; 



/* 



d e v '; . e t u p ■ i 1 1 i t i a 1 h a r d w a r e s e t u p 
entry : dew nb r 



the index number of the eprnm 

0 • 2516/2716 

1 - 2!>32 

2 2732 

3 • 2732a 

4 - 2564 

5 -• 276-1 



exit: return the following. 

ERROR • omniprog rammer nut connected or devnbr out 

of rauyu 
OK - no p rob 1 emir. 

a i. y o i • i thtt : in i t i a I i z e t ! t e h a r d w a r e 

disable ail pins 

check daw ub r to make sure it is in ran no 
set uo the voltages For the target eproai 
map the pin a to their socket relative values 
r e t u r n 



notes • a J 1 pins are disabled on exit 
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i n t. 
i n t 
C 



pwcjister 



( dev nbr ) 



int 


d 1-27 1.6 ( 


i nt 


dw27i.6 < 


i ii t 


pv/2716 ( 


i nt 


c d27 16 ( 


1 n t 


clr 21)32 { 


i n t 


dw2S32 < 


i. n t 


pw2R3a ( 




cd2532 ( 


X lit 


dr 2732 ( 


i nt 


dw2732 ( 


i n t 


pu2732 ( 


int 


cdS732 ( 


i t \ t 


dwa2732 


i n t 


drS!>64 ( 


i n t 


dw2i>64 i 


i n t 


pv/2564 ( 


i n t 


c d25 61 ( 


i n t 


d «-27A4 ( 


:i. n t 


dw2764 ( 


i n t 


pv2764 ( 



nt 



) ; 



tdeunbr - : deunbr; 

' $ i n i t ) ( ) ; 
(*disall) (); 
^devep^ap ~ 0; 
Keppaddrs ~ 0; 
rtnc:od« OK ; 
setup =• Nt); 
(*<;etcul) ICURRV1); 
(*aetcu2» (CUIHW2) ; 



is anybody out there? 



if (H*connect) ()) C 

*devei*i'or * CNCTERR ; 
rtncode ERROR; 

i 

elsts C 

(tledon) (CHECT) ; 

3 

Uledoff) (PRGRAM 1 PGERR I 5KT1 S 5KT2 ! 5KT3) ; 



/* 
*/ 



« a k e s up *:■> t h e u o c it et is e m p t y 
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if (rtnccide ««« OK) C 

Usett.hr ) (CHPCHK) ; 
if ( ! empty U ) f 

«de«erpop * NOT EMPTY ; 
i' t iu.:ode -~ ERROR ; 

> 



/* 



*/ 



set up voltages Far the target device 



if ( i" trie ode 
■j ecu 
u i h v 1 
uihuS 



OK ) C 

• : calibrate 
■-- calibrate 
::: calibrate 



vpplvi - calibrate 
vpplv2 •-• calibrate 
\.' p p 2 v i ~ c a 1 i b i- a t e 
v p p 2 u 2 " : c a 1 i b r a t e 



( UCC , 
( VIII , 
(U1H, 
(VPP1 , 
(VP PI , 
( VPP2 , 
( VPP2 , 



U3) 
VI ) 
V2) 

VI) ; 

V2) ; 

VI) ; 

V2) ; 



Udisall ) ( ) ; 

(*setvl 5 ( vihvi ) ; 

(*setv2) (vihv2) ; 

(#s«atv3) ( veov 5 ; 

(Xsetthr) (THRESH) 



switch (tdevnbr) r 

ease 0 : 
case 1 : 
case 2 : 
ease 3: 

c c n f i q ->pincnt = 24; 
break ; 

ease A: 
ease V> : 

c: o i i f i q - > p i n c n t 2 8 ; 
break ; 

def aul t : 

:* 1 1 e v e r- r o r ; " PA R M E R R ; 
rtneode ~ ERROR; 



/* 

map the pins to their socket relative values 



switch ( tdevnbr ) i 
ease 0 : 

cepgm ~ 30 ; 

cie « 32; 

vpp ■- 33; 

vce " 36; 

adr tab ~ am a pi ; 



1% pin 10 */ 

1% pin 20 tl 

1% pin 21 */ 

/# pin 2-1 */ 
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cat. a 1. : 



cass 2: 
ca&e 3: 



con-Fig- 


> e i n f o . c p r o m . p r o m 1 e n = 


- 20 40; 








nau k 


== 0x07ff; 










U 1 


— ii O '7 1 i ■ 










dw 


- dw27l6; 










PU 


* pu2716; 










cd 


« cd2716; 










break ; 












pdpcjw 


« 32; 


/* 


pin 


20 


%l 


vpp 


« 33; 


/* 


pin 


21 


%l 


ucc 


« 36; 


/* 


pin 


?A 


tl 


ad r tab 


« am tip 2; 










conf ig- 


>cinfct . cprorn . promlen - 


= 4096; 








nask 


0 x 0 f f f ; 










dr 


drSb32; 










dw •" 


dw2532 ; 










p V.' "~ 


pv2532; 










cd 


cd2532; 










break ; 












ottpgut 


« 30 ; 


/* 


pin 


10 


#/ 


ooupp 


« 32; 


it 


p i. n 


20 


*/ 




- 36; 


i% 


pin 


24 


tl 


adr tab 


~ : amap3; 










conf 'Ag- 


> c i n f o . c p r* o m . p r o m 1 «? n = 


•■■ 4096; 








in ask 


0 x 0 f f f ; 










t j r 


d 1*2732 ; 










p v :: ' 


pu2732 ; 










cd 


cd2732 ; 










if (drvnbr ----- 2) 












dw « dw2732; 
























dw - dwa.2732; 










break , 












v/pp 


* 11; 


ft 


pin 


1 


*/ 


r.-sl 


= 12; 


ft 


p i n 


a 


*/ 


pdpgm 


» 32; 


It 


pin 


22 


tl 


•j ecu. 


« 36; 


It 


p i n 


26 


tl 


cs2 


=■ 37; 


/* 


p i n 


C / 


tl 


v^c 


3(i; 


It 


p i n 


23 


*/ 


ad r tab 


- amap«1; 










CiOilf - 


> c :L i ii f o . c p r a m . p r a in 1 e n ■ 


■■ 8192; 








i*a& k 


Oxlfff; 










dr 


= di'2564; 










dw 


; - : dwS^^^j 










pu 


™ pv2?.>64; 










cd 


=•■ cd2£t64; 










be oak ; 












wop 


- 11; 


/* 


pi n 


1 


#/ 




* 30; 


/* 


pi n 


20 


*/ 




=- 32; 


/* 


pin 


22 


tl 


pu» 


~ 37; 


/* 


p i n 


27 


tl 
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/* 



*/ 



VCC 


■■■■■■ 30, 


adr i. Etb 


" a map 5; 


eon fig ■■ 


■>ei n fa . c 


mas it 


- Oxlfff 


dr 


•■ dr 276-1 


dw 


« dw2764 


pu 


" pv2764 


C.:d 


« cd2716 


break ; 





/# pin 28 */ 
8192; 



if < r trie ode !« OK) C 

Uledun) (RGERR); 

'.) 

e J. s <3 C 

(*ledon) (5KT1); 
setup " Yl£5; 

> 

return ( r tueude 1 ; 



d « u r e at (.1 ■■■ r e ad the 8 bit byte addressed 

entry: addr ••• the address af the byte ta read 

■ixit: return the following: 

ERROR - pin number out of range nr invalid parameter 
the value of the addressed byte if successful 

algorithm: check the range of addr. if out cif range 

return ERROR 
power tin the chip 

apply the address to the address pins 
read the output pins 

return the walue read from the output, 

notes: it is assumed that the pins are disabled on entry, 
all pins are disabled on exit. 



itn devread (addr, auxbuf , length) 

i nt addr ; 

char ftauxbuf ; 

int length; 

r 

int readbyte i ) ; 

saddr :: add i' ; 
sauxbuf ~ au^buf ; 
s length " : length; 



1% 



check to see if we are reading the gang buttons 



41 



*/ 



if ( (^connect ) ( ) ) C 

if (saddr R UNBUTTON ) t 

if ( ( * i- d p in) < RNBUTTQH ) HO ) 
return ( YES ) ; 

el i: H e 

return { HO ) ; 

} 



if Isaddr •-= •■= RE5ETBUTTON) i 

if ( ( * r dp i n ) ( R 5 BUTT ON ) «■* NO ) 
return ( YE5 ) ; 

e 1 s a 

return (HO) , 



/* 

are we ready to gci? 

*/ 



i f ( prom tie tup ( ) < 0 ) C 

(*l*don) (PGERR); 
return (ERROR) ; 

.} 

Udr) ( ) ; 

p t • ci o pin ( r a d b y t e ) ; 



(Sdisall ) ( ) ; 
return - s Icm Kith ) ; 



:i. nt prom set up ( ) 

is th*» hardware set up7 



:i.f ((setup =■■= HO) ! 1 <(*getthr) () — 0)) i 
if (devsetup (tclevubr) < 0) 
return (ERROR); 



is any body out there'? 



if ( ! Uccinnec-t ) ( ) ) C 

•W^yeiTcir- CNCTERli ; 
return (ERROR); 

3 

Uledoff) (PGERR); 
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Ulodonl (CNE'.CT); 



/:* 
*/ 



r 



:ia the chip in the *.:;r.icket and in the riqht place*? 



Usetthr) (CHPCHK); 
i f ( empty ( ) ) C 

tdaueppor = NQCHIP; 

return (ERROR) ; 



if ( Urdpin) (uccl !- 0) C 

*deuerroc « ORIENTATION ; 
return (ERROR) ; 

} 

U&elthr) (THRESH); 
return (OK) ; 



«:> t a t i c 

int dr2716 ( ) 



(*alt2pin) (wee) ; 
' #setp i n ) ( vpp ) ; 
' Srespxn ) ( eepgw ) ; 
( Kresp in ) ( oe ) ; 
retu r n ; 



static 

int dr2532 () 

i 



( jjtal t2pin ) ( ucc ) ; 
(*£ietpin ) ( vpp 3 ; 
( $respi n ) ( pdpgm ) ; 
return ; 



static 

int dr2732 () 



( #al t2pi n ) ( ucc ) ; 
(#respin) (cepyw) ; 
($re&pin ) ( aeupp ) ; 
return ; 



s t a t i c 

int dr'e&6<4 ( ) 
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( #set pin ) ( vec ) ; 
(ftaltSpin) fucca) ; 
Ual tap in ) ( vpp ) ; 
(*respin) (csl J ; 
( #respin ) ( c&2 ) ; 
( )5<resp in ) ( pdpcjin) ; 
retur n ; 



static 

int 

C 



dr2764 ( J 



($setp i n) 
( £respi it ) 
( # res pi n ) 
i • etur n ; 



( vac ) ; 
( vpp ) ; 
(ce) ; 
(ue) ; 



1% 



devwrite - write a value to a 0 bit byte 

entry: data - the value of the byte ta write 

addr - the address of the byte ta write 

exit: retur u the I o J. 1 aw i ncj : 

ERROR - invalid parameter ar unsuccessful write 
data return the data i-f successful 

alga pi th* : 

not.es: it is assumed that all pins are disabled on entry, 
all pins are disabled on exit. 



*/ 



i n t 
1 n t 
char 
int 



devwr its 
addr ; 
*auxbuf ; 
J.?! Hjlh ; 



(addr, auxbuf, length) 



saddr 
s auxbuf 
slencjth 



addr ; 
auxbuf ; 
length; 



if (prciKsetup ( J < 0 ) C 
Uledori) (PGERR) 
return (ERROR); 
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.} 



r 



(rj.oc.kir.) (PUGRAM) ; 

Udw) (); 

UdisaU) (); 
medof f ) (PRGRAK) ; 

if (rtnoode < 0) £ 

Sdeverror « PROG ERR ; 
(ftledcm) (PGERR) ; 

\ 

O'J.S0 

*deuerrtir --" 0; 
re turn ■ rtitcada ) ; 



static 

iut dw271& ( ) 



int pr&gpin ( ) ; 

( :{<setvl. ) ( vpp .lv J. I ; 
t $r@spi n ) ( cepgm ) ; 
OaltSpin ) ( vco ) ; 
($&etpin ) ( vpp ) ; 

rtncadfl ~ : pracpin (prngpin); 

! * s e X v i ) ( m i h v 1 ) ; 
(fcdispin 5 ( vpp ) ; 
ret a r n ; 



static 

int dw2i>32 () 



int. pragpin ( ) ; 

(ftsetvl ) ( vpplvl) ; 
(*alt2pin) t vcc. ) ; 
( ftsfttpi n ) ( vpp ) ; 

rtneade " prcicpin (prugpin); 

(Xsatvl ) ( v i h v 1. ) ; 
(Kdi&pirt ) { vpp) ; 
rot urn ; 



static 

int dw27<32 O 



register int i ; 
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int progpin ( ) ; 

(tresall) (>; 

for (i - 0; :L <= upplu2; iff) C 
Udelay) (2) ; 
(*setv2) ( i ) ; 

> 

(tdisalll (); 
(?alt2pin) ( ucc) ; 
( ftsetpin) ( ueupp ) ; 

rtnoode " procpin (progpin); 

(ttdispin) (aevpp) ; 
Us.et.v2) (uihu2) ; 
return ; 

:> 

static 

int dwa2732 ( ) 

{ 

register int i; 
int progpin ( ) ; 

Uresall) (); 

for (i « 0; i <~ upp2v2; iff J i 
(ftdelay > (2) ; 
(*setv2) ( i ) ; 

> 

Udisall) O; 
(*alt2pin) (ucc) ; 
( *s?itpin ) ( aeupp ) ; 

rtnopde =- : procpin (progpin); 

( $dispin ) ( aeupp) ; 
(*setu2) (vihv2) ; 
return ; 

:> 

static 

int «.lw2£i64 () 

C 

int progpin ( ) ; 

(*metyl) (uppiui); 
( fcsetpin ) ( ucc ) ; 
(taltSpin) (vcca) ; 
( Sststpin ) ( upp ) ; 
(ttrespin) (eel ) ; 
(>Sr«spin ) (cs2) ; 

rtncode procpin (progpin); 
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(ftsetvl J I uihvi ) ; 
( Kdispin ) ( v/pp ) ; 
rv> t u r n ; 

'} 

static 

int dw27fc-'l ( ) 

C 

int prugpin ( ) ; 

(Ksetul ) ( vppEvl ) ; 

( $setpin ) ( vc.-c ) ; 

( ftsetp in ) ( vpp ) ; 

(fcrespin) Ice) ; 

rtnoode ~ : procpin (ppogpin); 

(#setul ) ( vihvl ) ; 
( ftdispin ) ( wpp ) ; 
pet up n ; 

a 

int procpin (function) 

int (*f unction 5 ( ) ; 

{ 

oldaddr : ^ OxFFFF ; 
address = : saddr; 
buffer =- sauxbuf; 

fop (index ■■■ 0; index < slength; index H ) I 
add p '.Line ( ) ; 

if ( (#f unction) ( ) < 0) C 

*erraddrs = address; 
return (ERROR) ; 

:> 

oldaddr - address; 
address-l- i ; 
buffer+K; 

i /* end of -Fop *! 

return ( slength ) ; 

:> 

static 

int progpin ( ) 

{ 

(*ed) (); 

if (got data ~~ *buffer) 
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return (OK) ; 
stp =" TP1; 
flpra ~ prcigverf ( ) ; 
stp « TP 2 ; 
errb =•• pragverf ( ) ; 
if (err a ** NO) i 

stp == TP3; 

prngverf ( ) ; 

} 

if (errb ==== ; NO) t 
stp " TP4; 

if ( progverf ( ) NO) i 

*deverrar - PRQGERR ; 
return ( ERROR) ; 

} 

:t 

return (OK) ; 

:> 

int progverf ( ) 

C 

(Kpv) (); 

if (gatdata ! " Kbuffer) 
return (NO) ; 

else 

return ( YE£> ) ; 

} 

static 

int pu27J.6 ( ) 

{ 

data fcbuf f er ; 

datalset ( ) ; 

( $dispiri ) ( cepgm ) ; 
(fcdelay) (stp); 
(Xrespin) (cepgw); 

dataldis ( ; ; 

e<12716 ( ) ; 

i 

static 

int cd27I6 () 

C 

( ftrespin ) ( oe ) ; 
gatdata ~ datalget ( ) ; 
i #di spirt ) ( oe ) ; 

} 
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s t a v. 3 c 
i n t 
C 



pv2532 ( ) 



data Htbuf-Fer; 

datalset ( ) ; 

< Krespx n ) ( pdpgm ) ; 
(ftdelay ) ( stp ) ; 
(Kdispin ) ( pdpgm ) ; 

data.!. di.s ( ) ; 
cd2532 ( ) i 

) 

static 

int cd2»92 () 

£ 

Itsetvl ) ( vihvl ) ; 
(*delay) (9); 
(*rws.pin i ( pdpgm ) ; 
gcitdata datalgst ( ) 
(*di spin ) ( pdpgm ) ; 
( $SRtui ) ( upp Ivi ) ; 



static 

int, pvS732 t ) 



data ~ * b u F f e r ; 

data! set ( ) ; 

( %respin ) ( cepgm ) ; 
(Jtdelay ) ( «tp ) ; 
(ftdispin ) leepgm ) ; 

dataJ.di.si ( ) 

ct!2732 ( ) ; 

} 

static 

int cd2732 ( ) 

{ 

i &r«spi n ) ( oevpp 5 ; 
(tfrespin) (cepgm) ; 



gotdata ~ data! yet ( ) ; 
(#dispiii ) (cepgm ) ; 
(fcuetpin) (nevpp) ; 



static: 

int pv2:.>64 ( ) 

f. 



ilaUi : - ^buffer; 

dat.al.set ( ) ; 

l*respin ) (pdpgw) ; 
Ude'iay) (stp); 
(ftdispin ) ( pdpgin ) ; 

data! d is { ) ; 

cd2!>64 ( ) ; 



static 

int cd2564 ( ) 



(#s«tvi ) ( vihvl ) ; 
(#delay) (9); 
(#respin) (pdpgn); 
gotdata - dataiget ( ) ; 
( *d:Lspiri ) ( pdpgn ) ; 
( *se tvl ) ( upplvl ) ; 



& tat i c 

int pu2764 () 

i 



data ~ HcbufFer; 

datalset { ) ; 

I #respi n ) ( pgm ) ; 
(tfdelay ) (stp) ; 
( ftdispi n ) { pgm ) ; 

dataldis ( ) ; 

cd2716 ( ) ; 
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S t HI. t. i c 

int readbyte ( ) 

r 

ftbufftti 1 : " clatalget (); 
return (OK) ; 

'} 

1% End of teproBl.c */ 
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User Modifications 

USER SPECIFIED ALGORITHMS 
User specified algorithms METHOD II: 

(see following pages) 

MMITWA . C /MMITWA . TAB 



03/01/84 
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User Modifications METHOD II Example: 



KM I TWA . c 



Hill Ti.--v: ftjocli;r PPoiiio 



la:-;, modified: 3/30/04 by . 5K */ 



*i nclude "a : pstdi u . h" 
'>? i nc I ..i de " a : <...->.. a ii Fia . h' 

/••;. 



•jettio -the Function pointer?- for the hardware inter "ace routine;;; 



* / 

■!l : itie] a lie 
/* 



"a. aahdw . h" 



s.«t as war; able;;, to hold Din numbers 



nt 
Lnt 
.,. t 

!.i:t 



ue . 
■-■ 'J. ; 
eS, 
V c c 



/a 



table:; fur chip Uiv.«graa»inq 



delude "u : »»itwa.. tab' 



*:/ 



di.??ii»« wultacses ne-idfrd by the proac 



>de fine 

£de ? i oe 
* def I uc 
■If : I e ? :i i i <- 
; S din f In.? 
Ude Fine 
; >i d>M ; i. n-r 
#de Fine 

int 
int 
itit 
i r. t 
hit 



V s I L. 
IT, CP 

THHE5H 

CUPCISK 

CUHfWl 
fJURRl'2 

j i .1. ; 
v/ec h ; 
vcop ; 
u u u t i ; 



0 

do 

101 

97 

97 

•!. 7 

25 

255 

355 



0 vol to */ 
/?!: 5.31 uoHs *•/ 
/* 11.73 vol to */ 
/>!: 11. . do ualts */ 
/:* 11.45 vol to */ 
/ ){: 2 01 v a 1 1 b # / 
!% 3.95 vol to */ 
It aaxi*u* current limit */ 
/ S m a k i m u m curr e n t 1 i m i t * I 
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ii define '.il 
frdefin* U2 
*; ci:-vF j ne UM 



ft 



d e •? i i i e t Si a u r o q r a in in i n q i n teru a 1 



*d*f ine TP 



/* 100 micro see a nek; */ 



/* 



u til. up lad bits 



#de?ine 


r.NECT 


OkOQ 


Sdef ine 


PHSRAM 


OxSO 


'id** fine 


f'GERP 


0x10 


*def in-? 


'tXTS 


0x04 


^define 


5KT2 


0x02 


4 tip f i hp 




0x01 


fcdef j ne 


ftAXTRY 


10 



ft 



tempo rar q variable* for code optimization 



lit 


setup ~ HO; 


/% 


successful dew setup flag 


lilt 


dab it ; 


/* 


data bit 




•: ii t 


r v. neude . 


/* 


Function 


return code 


A lit 


status ; 


/# 


procpi n 


status temp 


xnt 


add resa ; 


/* 


chip address 


iut 


oldaddr ; 


/* 


last address access ad 


xnt 


tamp ad dr ; 


ft 


temporary a d d r e s s 


iut 


i. (idex ; 


ft 


•For loon 


i ndn:< 


in?, 


q o t d a t a ; 


ft 


temp For 


ueri f y 


iut 


data; 


/# 


data byte 


eh a. i- 


: ?.bu f Per ; 


/* 


p d i n t e r 


into data buffer 


i ii 


saddr ; 


/* 


temp for 


addr paramo tar 




*Utiu Kbu f ; 


/* 


temp "or 


au><buF parameter 


.i.nt 


u J s n ( ! t h ; 


/* 


temp far 


1 e n <2 1 h p a r a m « t a r 


iut 


tdHvnbp ~ 0 ; 


/* 


tamp for 


d e w i c ta number i n d e x 


j lit 


mask ; 


/* 


address 


bit ma:,!; 


char 


$tiptr ; 


/* 


p o i n t e r 


into data pin array 


"IUi.l' 


S d a cj ci r *j ; 


/ft 


p a i n t c r 


to address ntrinj 


char 


p d a t <•.; s ; 


/* 


pointer 


to data string 


I'har 


♦pprcrda ; 


/*: 


pa i. n tor 


t o p r e - read s t r i n y 


char 


-Kp&urris i 


/* 


p o i n t e r 


to post- read strinq 


char 


*pvjrs ; 


/* 


do i n t e r 


to write ct'rinu 


char 


pretrial a ; 


/:* 


poi nter 


to read data 


char 


Kpawrc , 


/* 


p a i n t e r 


to off sew in writs st 


1 n t 


prumwid ; 


/:* 


w i d t h o ? 


p r o m 



"3 



/* 

yet uo pointer to device error number and configuration t:::ble 
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i s i ti % i.! is* w r r u r ™ 0 >• 50c 

int *er r ad drs ■■■ 0:-:50o 

CCHWriC *c tin fig - r,j;310 



devv.wtup initial hardware setup 

e n v, r y : J » v n b r - t h e i. n cl a :•; n u m b e r c ■!•' t h a a prcn 

e x i t : r e t, u r n t h e f u 1 1 owing: 

ERROR ■•■ omni programmer nut connected or deunbr out 

of ran etc 
OK ••■ no problems 

alone :i. th« : initialize the hardware 

dir., able all pins 

c h & c V. d e vnbr to «n a k a & u r a i t i c in r a n y e 
set up the voltages For the target sprout 

map t h a pin s t o t h e i r s o c k a t r a 1 a t i a u a 1 u i" e 
r e t u r n 

notes : all pins are disabled on exit 



int devsetup (dewnbrl 

int davnbf . 

I 

rep is ter int 



* / 



t devnbr ~ : dcv,/nbr ; 

% i n :U ) ( ) : 
(fcdisa'llJ I); 
:K ij t* w«rrur ~ 0 , 
sfcerraddrs 0; 
r tneude : " OK; 
setup ~ HO; 
iKv-wtcvi) (CURRVi) ; 
(*s«tcw21 (CURRUS); 



is anybody out there 



if ! ! («cunnfect ) ( ) ) £ 

*douerrar CMC TERR 
rtneode ~ ERROR; 

« l«is f 

(* led tm) (CNECT) ; 

1 
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(*l«dc? f ! ( PRGRAM ! PGFRR ! SKTi ! SKT2 ! 5KT3) ; 



.' # 

make sure the socket is einptvi 



:„ f i rtncode OK ) { 

(Sfiatthr) (CHPCHK) ; 
if i !*»apt\| ()! { 

*(Jpu.?rroc ~ MOTF.HPTY ; 
rtncode ~ CRROR; 

3 



/* 



itc vultaqes -for the target device 



if t rtncode ~- OK) {'. 

uil MIL; 

v c >..■ !i - c a 1 1 b r a t e < V CC , U 3 ) ; 
vccp calibrate (VCCP , U3i; 
cutitS - calibrate ( VQUT2 . V2) ; 
voutl •■- calibrate? ( v'QISTI . VI) ; 



(Sdisall ) 

(*s~>tv2) 
(*sctv3! 
f x^fttthr ) 



{ j ; 

i vech ) ; 
'J veeh ) ; 
(THRESH) ; 



a a a ;.h' J pins t::» their socket relative values 



paddrs « aaddrlatr.dewnbr3r.03 ; 

pdataa •■■ SdatalEtCdavnbr 3T.Q3 ; 

;j p r « r d « ~ $ p r erdsLd e v n b r 3 C 0 3 ; 

poor da :: Spardsr.dcvnbr3r.03; 

p w !• s : " ?i wi's t r L dev nb r 3 C 0 1 ; 

prddata £ r • d d a t a ['. d e v n b r 3 r. 0 3 ; 

powr-i-; - SawrtCdevnbr 3C03 ; 

c o n f i cj • ■ > p In c n t ~ r. u it; p i rt s C d <?> v n b r 3 ; 

c!Jn-Fig->cinf('i . cpro-n ..pronlen ~ prlengC devnbr 3 . 

c ci 1 1 f i ii • • > riu -f o . c. p r a n . p r c nwi d •» p r a nt w i d ~ p r w i d i d '■• mbr 3 ; 

c;in Ficr > socket ™ uioci«sizeCdevnbr3 ;. 

cop-T L >c L n'"i:i eprom . prombl k " 0; 

i F ( d e w n b r ~ 3 ) v 

*(pu r i, 1 (*(paw r si/ 1 .))) u o u 1 5 ; 

3 

Slpwrs •'»■ (* < priwrsiS) ) 1 « v u t.; t ;L ; 
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$ ( a u r «•: i- ( t p a w r s 1 ! y c r p : 

'A ( r.iwps t ( '£ > ostjp ;•!• -!)) ) ~ vceh ; 

*(pwpf !• (*(gnwry K>) 5 ! - l ; 

i f ( Ptncude ! ~ OK ) C 
c-i<t.au : ~ YE 5 : 

i ■? \ c o r.: !•. a i z si C d e \i n far! ■■■■ ™ * 5 
CKledanJ 15KT1.); 

p: J s e 

l*lf.-duni J5KT3); 



return t rtnct'd**) ; 



deuread •• read the 8 3it bvjte addressed 

entri;: rid Up - the ud dress c" the byte to read 

■»j:it: return the f I &wi : 

nnnQR - pin number out o! ; ranqe ar invalid pa. ram .:• 
the 'jiiiud n-f the addressed bute i ? success -Pul 

a I OOP i thro : -hrc''. iv ho range af addr , i -P nut <:i '•' range 

return ERROR 
power cr the chip 

:;:pply the address x,o the address pi nr. 
read the output pins 

return the yalue read Froa the ouv.pi.it 

noti"£ : it is assumrd what the pins are disabled or entry 
all pins are disabled an exit. 

devre;>d (addr, auxbu? , length) 
addr ■. 
:?-aa >. bu -F ; 

1 e n g t h ; 

int. data; 

saddr ~ addr ; 
sau>. bu F ™ au; bu t ; 
vi 'l. -Mivj th ■•■ '.! er.jjth ; 

are we r«&dij to qo'? 



:i. F ( p r n in s e t u p '■ ) < 0 5 

f^iednnS [ RCERR * ; 
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/ :3 
t i 



return {ERROR) ; 

o3 :laddr ~ 0 xFFFV ; 
stream ( oprer ds ) ; 

" ( i '» s a - i d r - u d d r ; 5 a d d r : ( ;;t. d d r 4 1 e n q t. h ) , s a d d r 4-r 1 
mnpword ( olueiddr . 3Addr , paddra ) , 
■J.tt.a -■ assemble! prddata'> ; 
vai.i x bu F [• 5 : : duv.a , 
dldriddr ■■- saddr ; 

3 ; 

st r :, a!i» ( p nurds ) ; 
i H-rJ i.r.aJ.1 5 (); 

i i r n t e. length ) ; 



i 11 t iJ P !.i ill <.:> :i t U D M 



3 s. the hardware set uo? 



i " ((setup NO) !! (Uaetthr) ! < 0 ) S i 
i ? (devac-tup (td<»vnbr) < 0; 
return (ERROR); 



is anybody nut there? 



if ?! iStconnec-i ) ( ) ) f. 

*dsw-!rrop CMCTERR ; 
return (ERROR) ; 

J- 

iSledoFf) ( PC ERR ) ; 
(tled..:n) (CNCCT); 



is the chip in the Bucket and in the right place? 



< Ssetthr ) (CHPCHK) ; 

if (empty (!) f. 

*d«ueppup ~ NOCIIIP 
return (ERROR) ; 



•F 5 isrdpiri) luce) !« 0) C 

*d«.}Wc»rror ■■■■■ ORIENTATION 
return ' ERROR ) ; 



:*setthr- ) (T1IREGK) ; 
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n, 



<l«vwri w • write <; wa'-ua t o a C bit, byte 

citti'y : data ■• h >- ■ val u? of t h a b-;tr: v. a wriv-e 

ixudr ■- Live fcicMreiiS of the butt t.;i write 

exit: return th« fa 3. 1 a wi r.y 

ERROR •- invalid parameter or um-.-ucceir-uf ul write 
data - return the data i •(•' succc&s ?ul 

a.l gar i thro : 

notes : it i j;, assumed that all pins are disabled en -jntr «,: . 
all p .1 r. & a r ? % c I i. </. a b 1 e (J a n e :•: i. t . 



lievwritu ( ;;. ddr , au " h u ? . la n q t h ) 

addr: 
Saurbuf ; 
iei-'jv.h ; 

inv. dais ; 

register ?.:hf tr ; 
i r.t namti'M ; 

Lilt i>r oifidii ta ; 

:int i; 

saddr •• a ddr ; 
sau ; bu f ~ uu bu v ; 
s j si r. ' t h - 1 enuth ; 
rtneode " lenqth ; 
/* 

.'•n- we reijdi.) ta go'? 

*/ 

:i f I Dromsetsjo U < 0 i C 

{*l«dar.) (PGFRR); 
return ( ERROR) ; 

latli-fdon) 1 PRGRAft ) ; 



ir.t 

ch ar 
i (i v. 



/* this i u whs're the write alnarith* c;aos #/ 

olduddr - Ox r n-F, 

f!.;p t saddr addr ; saddr •:. addr ;■ length rtneode >~ 0 , r»addr +••••) C 
« a p w a r d ( a 1 d a d d r , si a d d r , p a d d r s» ) ; 
uldaddr r.addr j 
stream ( pprerds } ; 
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p r o in d a v, a ••■ iujijfBbk 1 i prddata) ; 
streit* ( ppordy ? ; 
daU; -" *au::bu! ; H . 
s h F t, r •- i. ; 
j f (data ! ™ p r a in d ; t. \ a 5 f. 

"or I i~0 ; i<pro»wid ; ill) C 
i i : Uiata t ah-Ttrl ;! 

coy triad ( (pdatati I i*6 ) , (pwrr„ I * { powrc-'r3 J H ; 
cpy t,r iad ! i pdatas I i#6 + 3). ( pwrs. I Sipuwra + IS)), 
•for Cnumtry * 0 ; I ! I ppumdata £ ch-ftr ) I £S t. numtry < rtAXTRY 
t ream ( pure ) ; 
straam ( pprerdy ) ; 
pramdata « as able ' prddata! ; 
stream ( ppnrds ) ; 
i i ; ioraiiJaia E sh-ftr) C 
lire, ream ( pwrn ) : 
'■uond ' ! ; 
s-.and ! ) ; 
s-"-nd ; ? ; 
!.■: e n d < ) ; 

3 

tahftr •"' «-,h ftr < < 1 : 

2 

i s « t w 3 ) t vech J ; 

stream ( pprcrds 3 , 

promdata - « sseabla J orddat.a ) : 

st r rats i ppard*.; ) ; 

i F ( o r (.< m da t a ! ~ d e t a ) "'. 

rraddr-i - add" ; 
rtneode - CRRQR; 

3 

3 

- ; 

Udisall ) I ) : 

It vv.d of writs: a 1 r - ■ i. thin */ 



Ulttdof-PJ I PREPAY } ; 



i* (ptucnd';' < 0) I'. 

adeverror - PFJOGERR ; 

3 

:V dv: j \/'.?ppi.i r =- 0 ; 
r*: turn ( rtrcadr-' ' ; 



M arid n? t«^*olat«s */ 
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METHOD II Example con't. 



rs tile: ■■■■■ mmttvja . TmB si 

ft mi T.i pit. tubl^; * / 

/'•? >.l\»v- -num id<s!\iic« jiz- uacke't pea numpin 

C 63a 2 4* :25c, X 1 J n lu 

.;. 63 s 2 41 012 X 4 3 n 16 

2 63 2 20 48 XI 3 n 1 8 

3 63;., 16 41 4096 X 4 2 n 20 



r.niAti c int. nuapi ijuC-'D. - C 16 , 16 , 18 , 20 } ; 
liUuir int. suck s L zoC 1 3 C3 ,3,3.31; 
static inl prlengC43 ~ C856 . 512 , 2C4<2 , 4096} ; 
s» 'catic int. dC13 - C4 , 4 , 4 . -1 5 ; 

tatic char a i " d $ C -13 LI 0 3 ~ C 

coxoc.oxoa.oxrr , oxoc , oxoo , oxrr , oxoi , oxco .. oxfr , oxff} , 

cox on o>:o3, oxrr .oxoo .oxoo . oxizr . oxFFi . 

coxon , ox 30 , oxrr , oxoo , oxoo cxro , Oxfh , 

: oxoo . oxoc , oxrr . oxoo , oxoo , oxr? , oxoo , oxoo , oxro . Oxrr 3 . 

!j tat, char pt.-.r»1y~43HiO!] ~ i 

coxoo , oxio , oxrr , 0x01 , oxo-'i , oxrr , oxoc. .0x00 . ox.rc .. o*ff3 , 

roxoo . 0x1 ;> . oxrr oxoc . oxoo , oxrc , oxff 3 1 

coxoo , 0x02 . oxr r . oxoo , oxoo , cxcr , oxff:: , 

coxoo ,oxoi oxrr . oxoo ,0x02 , oxrr oxoo , oxoo , oxr 3 ,o;.rn , 

': ; 

tat:: c c h«r swrs.C43C61 ~ f. 

C3.,9 .14,24,32,35:) , 
V.}. , 6 , 11 ..21 ,29 , 333 , 
f.3 , 6 , 11 ,21 ,29,323 , 
C8 ,9 ,14,42.50 ,533 , 

3 ; 

vitat.i ;' -rliur wrstrT 13CSCil -= ?'. 

cox 01 , oxoo , oxFD , oxoc . oxo3 , oxrr , oxi2 , oxrr , 100 , oxrr , oxrr , oxrr : oxio , oxrr , 94 
oxoc . oxco , oxrr , oxoo , oxoo , oxrr , oxoo , 0x10 , oxrr , oxrr . oxff , oxrr , oxoc , oxoo . oxrc , 
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0X1 ? . OXFF , 44 0X1 0 . CXFF . 0 ; 0X0 j. , 0X0 1 . OXFF , OxFF3 



'OXOC , 0X03 . OXFF ,0X12 , OXFF , 100 , OXFF , OXFF , OXFF , 0X10 , OXFF . 9-1,0X00 , 0X00 . OXfF , 
0X00 . 0X00 : OXFF , CXOC , 0X10 . OXFF , CXFF t OXFF , OXFF , OXOC , 0X00 .OXFC , .0X12 , OXFF , 

•'!4, 0X10 , CXFF , o.osrrj. 

COX 00 , 0X30 , OXFF .0X12 . OXFF . 100 , OXFF , OXFF , OXFF ,0X10 , OXFF , 94 , 0X00 , 0X00 , OXFF , 
0X00 ; 0X00 ,OXr» , CXOC , 0X02 , OXFF , OXFF ..OXFF , OXFF . OXOD , 0X00 , OXCF , 0X12 , OXFF , 44 . 
OX'.i 0 , OXFF , 0 , OxFFl . 

: 0X00 , 0X00 , 0XF7 , OXOD , OXOC , OXFF ,0X12 ,OXFF . 100 , OXFF , OXFF , OXFF , 0X11 , OXFF , 94 , 
0X00 , 0X00 : OXFF . 0X00, 0X00 , OXFF , 0X00 , 0X00 , OXFF , 0X00 ; OXOC , OXFF , OXOO , 0X00 , OXFF , 
0X00 , 0X00 , OXFF , 0X00 ,0X00 , OXFF , 0X00 ,0X00 , OXFD ,0X00 ,0X02 , OXFF , OXFF , OXFF , OXFF , 
0X0 ! ) . 0X00 , OXF'3 ; 0X12 , OXFF . 4-1 , CXI 1 , OXFF , 0 . 0X00 , 0X08 , OXFF , 0 jcFF } t 

3 ; 

•U. tic char i:uidrlfit:4:iL733 ~ f 

C 2, OX 01 . 0X00 , OXFD . 0X01 . 0X02 , OXFF , 0X01 , 0X00 , OXFF , 0X01 ,0X01 , OXFF , 0X0 0 ,0X00 , 0XF7 , 
0X00 , 0X08 ; OXFF ; 0X02 . 0X00 , 0X7F , 0X02 . 0X20 : CXFF . 0X0 1 .. 0X00 , OXF 7 , 0X01 ,0X02 ,OXFF , 
0X01 , 0X00 , OXFF ,0X01 , 0X10 . OXFF ,0X01 r 0X00 , OXDF , 0X01 , 0X20 . OXFF . 0X00 ,0X00 , OXDF , 
0X00 0X20 OX FT' j , 

C9 , 0X01 . 0X00 .OXFD , 0X01 . 0X02 , OXFF , 0X01 , 0X00 , OXFF . 0X0 I ,0X01 , OXFF ,0X00 ,0X00 , OXF? , 
0X00 0X08 . OXFF . 0X02 ; OXOC , 0X.7F , 0X02 , 0X80 , OXFF , OXOi , 0X00 , 0XF7 , CX01 , 0XC8 , CXFF , 
OXi>S , 0X00 , OXFF , 0X01 , 0X10 , OXFF , 0X01 , 0X00 , OXDF , 0X01 . 0X20 , OXFF > OX 00 ; 0X00 , OXDF , 
0X00 0X2.0 . OXFF , 0X0 1 ; 0X00 , OXFF , 0X0 1 , GXC4, OXFF? , 

Cll , 0X02 , 0X00 , 0X7F , 0X02 f 0X20 . OXFF ,0X01 .0X00 , OXFD ; 0X01 ,0X02 : OXFF ,0X01 ; 0X00 , OX.FE ( 
0X0 ' . 0X0 x , OXFF ( 0X01 : 0X00 , 0XF7 , 0X01 , 0X02 ; CXFF , 0X01 , 0X00 , OXFF , CXO_ ,0X10 ,OXFF , 
0X01 , 0X00 , OXDF , 0X01 ,0X20 , OXFF , 0X01 , 0X00 , OXDF , 0X01 , 0X40 , OXFF ,0X04 ,0X00 ,OXDF , 
0X0-1 .. 0X20 t OXFF , 0X00 ; 0X00 , OXDF , 0X00 , 0X20 , OXFF . 0X01 , 0X00 , OXFD s 0X01 ,0X04 , OXFF , 
0X00 ,0X0 0 ,0XF7 ,0X00 . OXOC , OXFF 3 , 

C12 , 0X01 ,0X00 ,0X""7 , 0X01 0X08 , OXFF ,0X02 , 0X00 , 0X7F , 0X02 . OXGO , OXFF .0X01 , 0X00 , OXFD , 
0X01 ,0X02, OXFF. 0X01. : 0X00 . OXFF , 0X01 ,0X1 0 . OXFF : 0X01 ,0X00 : OXDF , 0X01 ,0X20 ,OXFF , 
0X01 , 0X00 ,QX3F , 0X01 , 0X40 , OXFF , 0X00 , 0X00 , 0X7F ,0X00 , 0X80 , OXF F , 0X03 ,0X00 , OXDF , 
0X02 , 0X40 , OXFF , 0X01 , 0X00 . OXDF , 0X04 , 0X20 , OXFF , 0X00 , OXOO , OXCF . 0X00 , GX20 , OXFF , 
0X01 , 0X00 , OXFF , 0X01 , 0X01 , OXFF , 0X00 , 0X00 OXFF , 0X00 . 0X01 , OXFF} , 



«.:t«.it.ic char da*.;* 3. '.-t.r.'13C241 « C 

COXOB . 0X00 . OXCF , OXOD , 0X10 , OXDF , OXOA , 0X00 , OXCF , OXOA , 0X10 , OXDF , OX OA , 0X00 , OXFC , 
OX OA , 0X01 : OXFi.) . OXOA , 0X00 , 0XF3 , OXOA , 0X04 , CXF73 4 

COX OB . 0X00 .OXCF . OXOD , 0X10 , OXDF , OXOA , 0X00 , OXCF , OXOA , 0X10 , OXDF , OXOA , 0X00 , OXFC , 
OXOA , 0X0 i , OXFD . OXOA .. 0X00 , OXF 3 , OXOA ,0X04 , 0XF73 , 

10X02 , 0X00 , OXFC , 0X03 , 0X01 , OXFD , OXOD , 0X00 , OXCF , OXOD , 0X10 . OXDF , OXOA , 0X00 , OXCF , 
OXOA , 0X10 , OXDF ; OXOA , 0X00 , OXFC , OXOA . 0X01 , OXFD? , 

1 0 X 0 9.0X00,0 X F D , 0X09 , 0X02 . OXFF , OXOD , 0X00 , OXFC , 0X0 B , 0X02 , OXFF , OXOB . 0X0 0 OXCF ; 
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oxoB.Qxao , oxi:f , oxc^ , oxoo : oxer , oxoa , 0x20 , cxef} , 

3 i /* MOTE 635164: UFET5 U2 FOR PROGRAMMING UOLTAGE Vu 

ri'iiLt i.c char rdi!a'f.aC0:]r.?3 

•f.4.0 , 0X02 ,0 ,0X01 , 0 , 0X04 , 0 ,0X40} , 

<r. vo ; 0x02 o oxoi .0 , oxo 4 . 0 ,0x40 3 , 
0,0x01 ,0,0X0^,0,0X40,0,0X10} , 

{fl.O, 0X04 ,0 ,0X40 , 0 . 0X10 .. 1 , 0X0 0} : 

} ;' 
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METHOD II con't. 



Assembly Language Assist Routines 

For input to Stream 

Production Assembly Routine Stream 

;This routine takes a table of pin manipulation information which is 
;very timing sensitive and massages it in the background so that it can 
;be streamed to the hardware in it most efficient form. 

;the input stream must be pointed to by the first parameter on the stack 
;and be in the following format: 

j port address — 

; set mask 

: clr mask 



OXFF 



the destination string will start at 
will be in the following format: 

length 

port address — 
port data 



the algorithm executes as follows: 

calling sequence stream (ptr to stream) 

get port address whose data is to be modified 

get current data at that port from iostate 

modify bits indicated by set mask and clr mask 

put port address into pump string 

put desired data into pump string 

repeat until zero encountered in stream 

put count into first byte of pump string 

call pump to send the pump string cut at high speed 

return 

ON EXIT, register be preserved; hi, de destroyed 
Get the addresses for the hardware interface routines 



address of the omni port to be changed 
ones are bits to be set in that port 
zeros are bits to be reset in that port 

repeat as many times as needed 

end string with all ones 

the local location "pumpdata" and 

length of this data stream 
port to be modified 
data to be put at port 

repeat to length specified in first byte 
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METHOD II con't. 



For input to Mapword 

; Mapword 

; Mapword takes an 16 bit word and a map table and efficiently maps the bits 
;onto the pins indicated by the map table 

;the map table looks like this: 



#entries the number of entries in this word 

port ± 

setmask > hardware change if bit 0 of mapword is 0 

clrmask / 

port ± 

setmask > hardware change if bit 0 of mapword is 1 

clrmask / 



repeat for maximum number of mapped bits 
up to 16 



there are three entry parameters for mapword which are on the stack as per 
'C conventions. 



old word - integer containing the previous value mapped by mapword 
this is used to optimize mapword to modify only those bits 
which are different from one time to the next. If data is 
to be written for the first time, old word needs to equal 
the exclusive or of map word. 

map word - integer value containing bit pattern to be mapped 

pointer to map table - pointer to list of masks to implement 

hardware changes to make under various conditions 

mapword calling sequence is: 

mapword (old word, map word, pointer to map table); 

on return, the Omni pins will be set up vrith the new data pattern 
there are no return codes 



tmpstream: db Offh 
ds 48 
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METHOD II con't. 



For input to Mapword con't. 



;The algorithm uses both register sets to promote efficiency, and after 

;the setup code, the following registers are used: 

j de = the differences between the old data and the new data 

; hi = the new data 

; a = the offset from the current position of hi' to current bit position 

; hi' = pointer to the current position in the map table 

; de' = pointer to current position in the temporary stream data 

; b' = a temporary offset holding register 
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METHOD II con't. 



For data collection from Assemble 



Assemble Word 



This routine takes a list of port and bit mask assignments and 
assembles a word of data from them based on the state of the pins the 
list maps to. 

The assemble list has the following format: 

count 

port ± port address of the MSB to be read 

bit mask / position in port of bit to read 

± 

/ repeat two entries at a time up to 8 

ending with the least significant bit 

The calling sequence for assemble is: 

data = assemble ( rddatalst ) ; 



on entry: 



on exit: 



rddatalst is a pointer to the table shown above 



data contains the assembled data 
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USER MODIFICATIONS 



PORTING PROCEDURES 



PORTING OMNI SOFTWARE TO A NEW HOST MICROCOMPUTER 

Omni software is targeted for the Kaypro II cr IBM PC. The procedure that 
follows is required for operating the Omni Programmer on a host machine 
other than those two mentioned. It is conservatively estimated to be a 2 
week effort to completely modify and test the code. Varix will assist with 
technical support as necessary to answer questions. 

REQUIREMENTS: 

1. The processor of the target host must be Z-80 or 8088 and the operating 
system must be CPM/80 or MSDOS respectively. 

2. The machine must support a 16 bit parallel port with the following 
characteristics : 

8 bits output only port (address) 
8 bits bidirectional (data) 
2 strobe signals 

PROCEDURE FOR PORT OF OMNI: 

1 . Modify the following assembly language routines in OMHDW.MAC 

(a) Change read/write port addresses in init, pin, apin, pout, apout, 
pump. 

(b) Adjust timing routines for processor speed - delay, short delay, 
(code is written for 2.5 MHz Z-80, 5 MHz 8088) 

2. Reassemble the OMHDW.MAC routine as follows: 

M80 = OMHDW.MAC 

L80 OMHDW, OMHDW/n/x/e 

ZSID 

*L -103 

*Ac 

A>SAVE 16 OMHDW. OVR 

NOTE: Omni software is distributed in one of the following formats: 
8" floppy, single sided, single density for CPM 
5 1/4" floppy, IBM-PC MSDOS 2.1 
5 1/4" floppy, Kaypro II format, CPM 

PROCEDURE FOR PORT OF OMNI COM 

1. Modify interrupt initialization to support communications vector on 
new machine. 

2. I/O driver must be modified to support the communications controller 
if a port other than a Z-80 SIO. 
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Trouble Shooting 



PROCEDURES 



c Varix Warranty 

o Customer Problem Reporting 

Problems to be Resolved by: 

Customer Problem Report 
Communication by Telephone 
Written Correspondence 

o Customer Response Form 



Assistance Policy 



Varix will be of assistance to customer problems under 
warranty or granted through our maintenance contract. 
Please contact Varix to correct any problems you have 
regarding hardware, software, or service. 

We also encourage cur customers to forward any comments 
that may contribute to or enhance the use or cur Varix 
products. 

You may elect to use the Customer Problem Report, the 
Customer Response Form, or choose to pay us a visit. We 
take pride in serving cur customers. 
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Trouble Shooting 



User reference to: Varix Warranty 

For a period of one year after the purchase of the 
Omni-Programmer , Varix Corporation will provide the 
following at no charge to the customer: 

Immediate replacement of defective hardware with 
operational equipment. 

Immediate correction or replacement software to 
remedy any user identified programming error 
attributable to Varix. 

Upgrade of software to meet commitments to the 
customer made at the time of purchase. 

After the warranty period, software upgrades which 
will both correct existing problems and provide all 
current software enhancements can be purchased. De- 
fective hardware can be replaced or repaired for a 
single fixed cahrge. There will be a 90 day warranty 
period for each of these services during which any 
problems found will be fixed free of charge. 

Alternately, the customer may purchase a yearly main- 
tenance contract which will provide extension of the 
hardware warranty for that year and provide regular 
updates of software, including both problem fixes and 
enhancements, for that year. Minimum of 3 times/year. 

The foregoing warranties are in lieu of all other 
warranties express or implied including but not 
limited to warranties of merchantability and fitness 
for a particular purpose and are the only warranties 
made by Varix Corporation in connection with the 
equipment. Related documentation furnished by Varix 
Corporation and the installation assistance, if any, 
rendered by Varix Corporation. In no event will Varix 
Corporation be responsible for consequential damages. 
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Trouble Shooting 



Customer Problem Reporting 

Customer reference to the Customer Problem Report Form 
may expedite matters in a problem solving situation. 

Also, reference to the Varix Omni-Programmer User Manual 

may assist with your in-hcuse problem solving. In some 
instances this manual may aid in the definition or des- 
cription of your problem. 

The Customer Problem Report Form, included in this 
section, will afford the customer a current status of 
his immediate problem and when resolution is achieved 
will give him a documented source for future reference. 

When a problem exists the user should complete this form 
by: 

1 ) identifying the type of hardware or software 
in question, 

2) give a complete and thorough description of 
the problem, and 

3) list any additional information that may be 
of assistance to our customer service in 
recreating the problem at Varix for further 
study. 

The information given above will allow Varix personnel 
the opportunity to readily assist the customer. 

Please see "Contacting Varix" in this section to secure 
further procedure. 
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Trouble Sheeting 



Contacting Varix 

Communication by Telephone: 

a) have your Customer Problem Report ready 
to help you when you phone, 

b) specify to our Varix operator whether your 
your problem is hardware or software 
related, 

c) use your form to write down any response 
or advice the customer service engineer 
has given you. Use the "Resolution" area 
provided on the form, and 

d) keep your completed form for return calls 
or future reference. 



Written Correspondence: 

a) send all correspondence to cur mailing 
address: 

Varrix Corporation 

122 Spanish Village #608 

Dallas, TX 75248 

ATTN: Customer Service 

b) enclose with your cover letter a copy of 
the Customer Problem Report that you have 
completed. 

c) The resolution area of the form will then 
be completed by Varix and returned to you. 

d) Keep your returned and completed form for 
further correspondence and/or future refer- 
ence. 
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Trouble Shooting: Schematics 



Omni-Programmer Schematics 

The following pages contain the schematics for the Omni-Programmer models 
SP0300 and GP1K0. They are provided as reference for further understanding 
of the interface specifications. 

Nomenclature used in these schematics is: 

J1 (|l 4. 15^ indicates a part of a connector J1 
p. 6,9 are page references for the signal connection 

1 System ground 

U31 IC #31 Q1 transistor #1 

R15 resistor #15 C5 capacitor #5 

D7 diode #7 H LED #4 
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User Diagnostics 



BW is a Burn Test Program. It is a functional test of the Omni and will execute 
while loaded into either Drive A: or B:. It is available in any of the standard 
formats in which Omni software is distributed and a copy is included with this 
manual . 

Bw working with an IBM-PC. 
EXECUTABLE program. 

Insert DOS Disk - (MSDOS must be running) 

To indicate the default drive from A> to B>- 
Type B: i.e. 

A>B: (press Enter) 

BW procedure: 

A>EXEC:BW (press Enter ) or B>EXEC:BW (press Enter) 



When the menu appears: 



Depress B (Enter) 

This will give you a visual test both on the computer screen and with the lights 
on the Omni-Programmer flashing continuously. While the Continuous Burn In file 
is running if there is a failure then depress any key and return to the menu. 

Using the Menu continue to select the W, T, and E files to aid in locating the 
failure. When the failure is identified make a descriptive note as to the 
location and type of problem and call the Varix Customer Service Department for 
further assistance. 



B 
W 
C 
T 
E 
X 



Continuous Burn In 
Extended Wigpin Test 

Current Limit Test **Nct used for functional test** 
Test 1 .5 Volt Circuit 
Cross-effect Test 
Exit 
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User Diagnostics: Burn Test Program BW con't. 



BW working with a Kayprc computer. 



A>C0M:BW (press Return) or B>COM:BW (press Return) 



To access Drive B from Drive A 



A>B: (press Return) 



The screen will require a y/n response to Continuous Burn In. Y will initiate 
the Continuous Burn In file and a N response will give you the menu. 

While running the Continuous Burn In file should there be a failure then the 
RESET switch on the back of the Kaypro must be depressed. Bring up BW again and 
this time around answer N to get the BW menu. 

When the menu appears: 



Using the menu as a guide select the W, T, and/or E file to aid in locating 
the failure. When the failure is identified make a descriptive note as to the 
location and type of problem and call the Varix Customer Service Department for 
further assistance. 



W 
C 
T 
E 
X 



Extended Wigpin Test 

Current Limit Test **Nct used for functional test** 
Test 1.5 Volt Circuit 
Cross-effect Test 
Exit 
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title 'production hardware interface for the kayprc ii 1 

.z80 

cseg 

set up the jump table 



JP 


rpsfl 1 1 


JP 


r\ l sa T T 


JP 




JP 


H "i ^rn n 


JP 




JP 


a 1 +.1 ni n 


JP 


a 1 1 ?ni n 


JP 


n pna b~l p 


JP 


UUIO ^J_LI1 


JP 


n ^pt.m' n 


JP 




JP 


punip 


i n 
JP 


na T t2f)i n 




rdpin 


IP 


setvl 


■in 
JP 


setv2 


JP 




JP 


sptf*v1 


jp 


setcv2 


jp 


se tthr 


jp 


getthr 


jp 


ledcn 


jp 


ledoff 


jp 


connect 


jp 


init 


jp 


delay 


jp 


shcrtdelay 


jp 


pin 


jp 


apin 


jp 


pout 


jp 


apout 



; iostate contains the bit values written to each of the output pins. 

icstate: db OOh, OOh, OOh, OOh, OOh, OOh, OOh, OOh 

db OOh, OOh, OOh, OOh, OOh, OOh, OOh, OOh 

; pintab maps pin numbers to port addresses and bit positions. 

; the first entry is empty so that the indexes will be 1 relative. 

; each pin has the following information: primary port, primary port 

; bit mask, secondary output port, number of bits in secondary port, 

; bit mask in secondary port. 

pintab: db OOh, OOh, OOh, OOh, OOh ; dummy entry 



1 



cic U5h. 10h, OOh, OOh, OOh ;pin # 1 

db 05h, 20h, OOh, OOh, OOh ;pin # 2 

db 05h, 40h, OOh, OOh, OOh ;pin # 3 

db 05h, 80h, OOh, OOh, OOh ;pin # 4 

db 03h, 01h, OOh, OOh, OOh ;pin # 5 

db 03h, 02h, 08h, 01h, 01h ;pin # 6 

db 03h, 04h, 08h, 01h, 02h ;pin # 7 

db 03h, 08h, OOh, OOh, OOh ;pin #8 

db 03h, 10h, 08h, 01h, 04h ;pin # 9 

db 03h, 20h, OOh, OOh, OOh ;pin # 10 

db 04h, 20h, Och, 02h, 01 h ;pin # 11 

db 02h, 10h, 09h, 01h, 80h ;pin # 12 

db 01h, 80h, Odh, 02h, 40h ;pin # 13 

db 01h, 40h, 09h, 01h, 20h ;pin # U 

db 01h, 20h, 09h, 01h, 10h ;pin # 15 

db 01h, 10h, 09h, 01h, 08h ;pin # 16 

db 01 h, 08h, 09h, 01h, 04h ;pin # 17 

db 01h, 04h, 09h, 01h, 02h ;pin # 18 

db 01 h, 02h, Och, 02h, 10h ;pin # 19 

db 01h, 01h, Och, 02h, 04h ;pin #20 

db OOh, 01h, Oah, 02h, 01 h ;pin # 21 

db OOh, 02h, Oah, 02h, 04h ;pin # 22 

db OOh, 04h, Oah, 02h, 10h ;pin § 23 

db 03h, 80h, OOh, OOh, OOh ;pin # 24 

db OOh, 08h, Oah, 02h, 40h ;pin #25 

db OOh, 10h, Obh, 02h, 01 h ;pin # 26 

db OOh, 20h, Obh, 02h, 04h ;pin # 27 

db OOh, 40h, Obh, 02h, 10h ;pin # 28 

db OOh, 80h, Obh, 02h, 40h ;pin # 29 

db 02h, 80h, Och, 02h, ^Oh ;pin # 30 

db 02h, 04-h, 09h, 01h, 01 h ;pin # 31 

db 04h, 80h, 08h, 01h, 10h ' ;pin # 32 

db 02h, 08h, Odh, 02h, 01 h ;pin # 33 

db 02h, 02h, 09h, 01 h, 40h ;pin # 34 

db 02h, 01 h, 08h, 01 h, 08h ;pin # 35 

db 02h, 20h, Odh, 02h, O^h ;pin // 36 

db 02h, 40h, 08h, 01h, 20h ;pin # 37 

db 04h, 40h, 08h, 01h, 40h ;pin # 38 

db 04h, 10h, OOh, OOh, OOh ;pin # 39 

db O^h, 08h, OOh, OOh, OOh jpin # 40 

db 04h, 04h, OOh, OOh, OOh ;pin # 41 

db 04h, 02h, OOh, OOh, OOh ;pin # 42 

db 04h, 01 h, OOh, OOh, OOh ;pin # 43 

db 03h, 40h, Odh, 02h, 10h ;pin # 44 

db 05h, 01 h, OOh, OOh, OOh ;pin # 45 

db 05h, 02h, OOh, OOh, OOh ;pin # 46 

db 05h, 04h, OOh, OOh, OOh ;pin # 47 

db 05h, 08h, 08h, 01 h, 80h ;pin # 48 

; define the pert select values 

vlvolt equ 10h ; select v1 voltage 

v2volt equ 11h ; select v2 voltage 



2 



v3volt 


equ 


I du. 


; select v3 voltage 


v1 curr 


equ 


13h 


; select v1 current limit 


v2curr 


equ 


i A4.X1 


) OClCO Li V <. O UI 1 Cll Li -L-LIIl-Lli 


outthr 


equ 


15h 


; output threshold 


inthr 


equ 


Odh 


; input threshold 


ledport equ 


I6h 


;leds and current enables 



define return values 



true 


equ 


1 


false 


equ 


0 


error 


equ 


-1 



define the indexes into pintab 



primry 


equ 


0 


prmask 


equ 


1 


secndy 


equ 


2 


scbits 


equ 


3 


scloc 


equ 


A 



; primary port 

; primary port bit mask 

; secondary port (0 if none) 

; number of bits in secondary port (1 or 

jlccaticn of bits in secondary port (0 



define the address of the configuration table 



contab 


equ 


050ch 












define 


the parallel interface 


ports 




dbpar 


equ 


Oah 


;pcrt 


b 


data on 


parpic 


cbpar 


equ 


Obh 


jport 


b 


control 


on parpic 


dbsys 


equ 


1eh 


;pcrt 


b 


data on 


syspic 


cbsys 


equ 


1fh 


;port 


b 


control 


on syspic 


; dapar 


equ 


08h 


;port 


a 


data on 


parpio 


; capar 


equ 


09h 


;pcrt 


a 


control 


on parpio 


; dbpar 


equ 


Oah 


jpcrt 


b 


data on 


parpio 


; cbpar 


equ 


Obh 


jport 


b 


control 


on parpio 


jdasys 


equ 


1ch 


;pcrt 


a 


data on 


syspic 


jcasys 


equ 


1dh 


;port 


a 


control 


on syspio 


; dbsys 


equ 


1eh 


jport 


b 


data on 


syspic 


; cbsys 


equ 


1fh 


jport 


b 


control 


on syspic 
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; set up a byte to held the state cf the leds 

5 



leds: db 03fh 

; resall - reset all pins 

; entry: none 

; exit : none 

resall: push be ; save be 

Id b,0 

Id hl,icstate ;get the address of iostate 

rlocp: Id a,b Jget the port number 

cp 6 ; check the range 

jp z,rend ;stop if equal to 6 

Id e,0 ;zero the port 

Id (hl),e 

push be ;save in case apcut destroys their values 

push hi 

call apout ; output zero to the specified port 

pop hi ; restore 

pop be 

inc hi 

inc b ; increment to next port 

jr rloop 

rend: pep be ; restore be 

ret 

; disall - disable all pins 

; entry: none 

; exit: none 

disall: push be ;save be 

Id b,8 ;set up first port number 

Id hi, iostate + 8 ;get the address of the 8th port in iostate 

dloopl : Id a,b Jget the port number 

cp Oeh ; check the range 

jr z,dend1 ;stcp if equal to Oeh 

Id e,0 ;zerc the port 

Id (hl),e 

push be ;save in case apout destroys their values 

push hi 

call apcut ; output zero to the specified port 

pop hi ; restore 

pop be 

inc hi 

inc b ; increment to next port 



dendl : Id 
Id 

dlcGp2: Id 
cp 

jr 
Id 
Id 

push 
push 
call 
pop 
pop 
inc 
inc 
jr 
pep 
ret 



dend2: 



dloopl 
b,0 

hl,iostate 
a,b 

6 

z ,dend2 

e,0ffh 

(hl),e 

be 

hi 

apout 

hi 

be 

hi 

b 

dlocp2 
be 



;set up first pert number 

;get the address of iostate 

;get the port number 

; check the range 

;stop if equal to 6 

;set every bit in the port 

jsave in case apout destroys their values 

; output zero to the specified port 
; restore 



; increment to next port 
;restore be 



respin - reset a pin to its low value 

entry: parameter # 1 - pin number to be reset 

exit : none 



respin: 



call 

push 

call 

call 

pop 
ret 



parml 
be 

primary 

disprimary 

be 



jsave be 

;get the primary port information 
; disable primary bit 
; restore be 



dispin - set a pin to its tri-state value 

entry: parameter # 1 - pin number to be disabled 

exit : none 



dispin: 



call 
push 
call 
push 



parml 
be 

primary 
be 



;save be 

; get the primary port information 
jsave for later 
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setpin: 



inc 

Id 

or 

jr 
dec 


hi 

a, (hi) 
a 

z ,disprm 
hi 


; secondary port 


Id 
call 


d,0 

setsecond 


;disable decode 

;set up secondary bits 


pop 




• t»o q "f~ /- t»o + o fiT*"! rod t*~\t nr T»t i pi "p r y*tt\o i c.y\ 
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call 


enaprimary 


; enable primary bit 


pop 
ret 


be 


; restore be 


setpin - 


- set a pin to 


its high value 


entry: 


parameter # 1 


- pin number to be set 


exit: 


none 




call 


parml 




push 


be 


jsave be 


call 


primary 


;get the primary port information 


push 


be 


;save for later 


Id 

call 


d,1 

setsecond 


;set decode 

jset up secondary bits 


pop 




• T»o Q + r>T*P> "hVlO T)T*n TTIO T*V np,T»t. "1 ri f r.T'Tllfl t 1 (~.T1 
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call 


enaprimary 


; enable primary bit 


pop 
ret 


be 


jrestore be 


altlpin 


- set a pin to its alternate high value 


entry : 


parameter // 1 


- pin number to be set 


exit : 


none 




call 


parml 
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alt2pin: 



push 


be 


;save be 


call 


primary 


;get the primary pert information 


push 


be 


;save for later 


Id 

call 


d,2 

setsecend 


;alt1 decode 

;set up secondary bits 


pep 


be 


; restore the primary port information 


call 


enaprimary 


; enable primary bit 


pep 
ret 


be 


; restore be 


alt2pin 


- set a pin te 


its alternate high value 


entry: 


parameter # 1 


- pin number to be set 


exit: 


none 




call 


par hi 1 




push 


be 


; save be 


call 


primary 


;get the primary pert information 


push 


be 


;save for later 


Id- 
call 


d,3 

setsecend 


;alt2 decode 

;set up secondary bits 


pep 


be 


; restore the primary port information 


call 


enaprimary 


; enable primary bit 


pop 
ret 


be 


jrestcre be 


qenable 


- enable the primary pert for a pin 


entry: 


parameter # 1 


- pin number to be enabled 


exit: 


none 




call 


parml 




push 


be 


;save be 
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call 

call 

pep 
ret 



primary 

enaprimary 

be 



; enable primary bit 
;restcre be 



qdispin - set secendary pert fcr a pin te its tri-state value 
entry: parameter # 1 - pin number tc be disabled 
exit : none 



qdispin: 

call 

push 

call 

inc 
Id 
or 

jr 
dec 

Id 
call 

;qdisprm: 

pop 
ret 



parml 
be 

primary 
hi 

a, (hi) 
a 

z,qdisprm 
hi 

d,0 

setsecond 
be 



jsave be 



; secondary port 



; disable decode 

;set up secendary bits 



;restcre be 



qsetpin - set the secondary port of a pin tc its high value 
entry: parameter # 1 - pin number tc be set 
exit: none 



qsetpin: 



call 

push 

call 

Id 
call 



parml 
be 

primary 
d,1 

setsecond 



; save be 

;get the primary port information 
;set decode 

;set up secondary bits 



pop 



be 



jrestcre be 
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ret 

qaltlpin - set the secondary port of a pin to its alternate high value 
entry: parameter # 1 - pin number to be set 
exit: none 



qaltl pin: 

call 

push 

call 

Id 

call 

pop 
ret 



parml 
be 

primary 
d,2 

setsecend 
be 



;save be 

;get the primary port information 
;set decode 

;set up secondary bits 
jrestore be 



qalt2pin - set the secondary port of a pin to its alternate high value 
entry: parameter # 1 - pin number to be set 
exit : none 



qalt2pin: 

call 

push 

call 

Id 
call 

pop 
ret 



parml 
be 

primary 
d,3 

setsecend 
be 



; save be 

;get the primary port information 
;set decode 

;set up secondary bits 
jrestore be 



primary - get the primary port information 

entry: register e - pin number 

exit: register b - primary port number 
register c - primary port mask 



primary: 



Id 



a,e 



; multiply pin by 5 
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sla e Jget the port information for the pin 

sla e 

add a , e 

Id e ,a 

Id hl,pintab ;port table 

Id d,0 

add hl,de ; address in pintab of information 

Id b,(hl) ; primary port 

inc hi 

Id c,(hl) jpin mask 

ret 



disprimary - disable the primary bit 

entry: register b - primary port number 
register c - primary port mask 

exit : none 



disprimary: 



Id 


e,b 


;get the current state of all the bits 


Id 


d,0 




Id 


hi, iostate 




add 


hl,de 




Id 


a, c 




cpl 






and 


(hi) 


jmerge the select bits into the byte 


Id 


(hi), a 


;save back into iostate 


Id 


e,a 


;set up to call pout 


Id 


a,b 




call 


apout 




ret 







enaprimary - enable the primary bit 



entry: register b 
register c 



primary port number 
primary port mask 



exit: 



none 



enaprimary: 
Id 
Id 
Id 
add 

Id 
or 



e,b 
d,0 

hi , iostate 
hl,de 

a,c 

(hi) 



;get the current state of all the bits 



;get the mask for oring 
; clear the secondary bits 
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Id (hi), a ;save back into iostate 

Id e,a ;set up tc call apout 

Id a,b 

call apout 
ret 



setseccnd - set up secondary bits 

entry: register hi - address of byte preceeding secondary port 
register d - type of setup: 

00 - disable 

01 - set 

10 - altl 

11 - alt2 



; exit: none 

setsecond: 

inc hi 

Id b,(hl) ;seccndary port number 

inc hi 

Id a, (hi) jnumber of bits in secondary port 

inc hi 

Id c,(hl) ; secondary pin mask 

or a ; check for no secondary port 

ret z 

cp 2 

jr nz,cnebit ;cne bit decode on secondary port 

Id a,c 

sla a 

or c 
cpl 

Id e,a 

Id a,d ;get decode type 

or a 

jr nz,dec01 

Id a,e ;and mask in register a 

Id c,0 ;cr mask in register c 

jr decode 

deed : cp 1 

jr nz,dec10 

Id a,e ;and mask in register a 

;cr mask already in register c 

jr decode 

dec10: cp 2 

jr nz,dec11 
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Id a,e ;and mask in register a 

sla c ;cr mask in register e 

jr decode 

ded 1 : Id a,e 
cpl 

Id c,a ;cr mask in register c 

cpl ;and mask in register a 

jr decode 

cnebit: Id a,c 
cpl 

Id e,a 

Id a,d 

cp 1 

jr z,dec1 

Id a,e ;and mask in register a 

Id c,0 ;or mask in register c 

jr decode 

ded : Id a,e ;and mask in register a 

;or mask already in c 

decode: Id e,b J get the current state of all the bits 

Id d,0 

Id hl,icstate 

add hl,de 

and (hi) ; clear the secondary bits 

or c ;set the decode pattern 

Id (hi), a 

Id e,a ;set up to call apout 

Id a,b 

call apout 
ret 

; rdpin - read the value of a pin 

; entry: parameter # 1 - pin number to be read 

; exit: return true if the pin = 1 

; false if the pin = 0 

rdpin: call parml 

push be ;save be 

call primary Jget the primary port information 
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push 



be 



;save for later 



rtrue: 



Id 

call 
pep 

and 

pop 

jr 
Id 
ret 

Id 
ret 



a,b 

apin 
be 

c 

be 

nz, rtrue 
hi, false 

hi , true 



;set up to call pin 

;get the value for the pin 



; check the value of the pin 



;bit was not set 



;bit was set 



setvl - set the voltage of v1 

entry: parameter # 1 - the number of volts to set v1 to 
exit: none 

notes: the voltage can be set to anything between 0 and 30.60 
volts in increments of 0.12 volts 



setvl: Id a,v1vclt ;v1 output port is in register a 

jr setreg ; output the voltage level 



setv2 - set the voltage of v2 

entry: parameter # 1 - the number of volts to set v2 to 
exit : none 

notes: the voltage can be set to anything between 0 and 30.60 
volts in increments of 0.12 volts 



setv2: Id a,v2vclt ;v2 output port is in register a 

jr setreg ; output the voltage level 



setv3 - set the voltage of v3 

entry: parameter # 1 - the number of volts to set v3 to 
exit : none 

notes: the voltage can be set to anything between 0 and 30.60 
volts in increments of 0.12 volts 
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setv3: Id 



setcvl : Id 



setcv2: Id 



a, v3vclt 
setreg 



;v3 output pert is in register a 
; output the voltage level 



setcvl - set the current limit of v1 

entry: parameter § 1 - the number of milliamps to set v1 to 
exit : none 

notes: the voltage can be set to anything between 0 and 1020 
milliamps in increments of X milliamps 



a, v1 curr 
setreg 



;v1 output port is in register a 
; output the current level 



setcv2 - set the current of v2 

entry: parameter # 1 - the number of milliamps to set v2 to 
exit : none 

notes: the voltage can be set to anything between 0 and 1020 
milliamps in increments of X milliamps 



a, v2curr 
setreg 



;v2 output port is in register a 
; output the current level 



setthr - set the threshold voltage 

entry: parameter # 1 - the number of volts to set the threshold to 
exit : none 

notes: the voltage can be set to anything between 0 and 30.60 
volts in increments of 0.12 volts 



setthr: Id a,outthr 



;threshcld output port is in register a 



setreg - set a voltage or current register 

entry: register a - register address 

parameter # 1 - voltage or current level 

exit : none 



H 



setreg: call parml 

push be 

call apcut 

pep be 
ret 



;save be 

;cutput the register value 
jrestore be 



getthr - set the threshold voltage 
entry: none 

exit: return threshold voltage in hi 

notes: the voltage can be set to anything between 0 and 30.60 
volts in increments of 0.12 volts 



push 


be 


;save be 


Id 


a,inthr 


; threshold input port is in register 


call 


apin 


; input the voltage level 


Id 


1 ,a 


;put return value in hi 


Id 


h,0 




or 


h 


;set the zero flag 


pop 


be 


; restore be 


ret 






leden 


- turn on the 


leds 



input: the bits set for turning on leds and current limit enables 
output: none 



leden: 



call 
Id 

push 

xor 

Id 

Id 

and 

Id 

Id 

Id 

call 



parml 
a ,e 

be 

Offh 
e,a 

a, (leds) 
e 

(leds) ,a 
e,a 

a,ledpcrt 
apcut 



;save be 

; invert to clear bits 
;set up for pout 
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pop be 
ret 



;restcre be 



ledeff - turn off the leds 

input: the bits set for turning off leds and current limit enables 
output: none 



ledeff: 



call 

push 

Id 
cr 
Id 
Id 
Id 

call 



pep 
ret 



parml 
be 

a, (leds) 
e 

(leds) ,a 
e,a 

a,ledpcrt 
apout 

be 



;save be 



;set up for pout 



jrestcre be 



connect: 



cerr : 
exit: 



push 

Id 

call 

push 

Id 

Id 

call 

Id 

Id 

call 

Id 

call 

Id 

pop 

push 

Id 

Id 

call 
pop 
Id 
cp 

jr 
Id 

jr 
Id 
Id 
cr 
pep 



be 

a , inthr 

apin 

af 

e, 5ah 

a,outthr 

apout 

e,0ffh 

a, v1 curr 

apout 

a, inthr 
apin 

b, a 
af 
be 
e ,a 

a,outthr 
apout 
be 
a,b 

5ah 

nz,cerr 

hl,1 

exit 

hl,0 

a,h 

1 

be 



; save be 

;save the current threshold value 



; output test value to threshold 

; output current on v1 to remove 5ah from 
;the outputs of the pic 

;read it back in 



;save for later 

jrestcre original threshold 



;get test value 
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ret 



; init - 


hardware initialization 


; entry: 


none 


; exit : 


none 


; notes: 


this subroutine would do any initialization required for 
the parallel i/o pert and for the delay subroutine 


; algorithm: 

; the b port of the z80-pic at addresses 08h - Obh 
; is initialized for output with interrupts disabled. 
; this port contains the address for cmniprog. 




"hh p b nr,T*"h cf thp avstpm 7. 80— nir, af. addrpsaps 

uii v kj yJ W X U V> X CLIO kJ V iJ U\>lil ZJ **-J W LJJ^KJ cx w u.vavxx ^ uu VU 

01 ch - 01 fh is initialized for output with interrupts 
disabled for cutputting the data for cmniprog. this- 
port is reinitialized for input when reading data 
from cmniprog. 


init: Id 
cut 
cut 


a,0fh ;set up mode 0 

(cbpar),a jcutput to pert b of parpic 

(cbsys),a jcutput to port b cf syspic 


Id 

cut 

cut 


a,07h jset up interrupts disabled 
(cbpar),a jcutput to port b cf parpic 
(cbsys),a jcutput to pert b cf syspic 


ret 




; delay 


-100 micro second delay 


; entry : 


parameter # 1 - number of 100 micrc second tics to delay 


; exit: 


none 


; notes: 


this subroutine should be as accurate as possible, some 



devices have a tcllarence cf only + or - 10% and the calling 
overhead may account for most of it. this routine can be 
inplemented with hardware interval counters or software loops, 

registers a, d, e, h, and 1 are changed 



delay: 



j cuter loop - this leep takes 100 
jmicrc seconds per iteration 



call parml 



me 



hi 
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loop: 



Id 


d, (hi) 


;get the num 


push 


de 


;11 


t 


states 


Id 


hi, 5 


; 10 


t 


states 


dec 


hi 


; 6 


t 


states 


dec 


a 


; 5 


t 


states 


dec 


a 


; 5 


t 


states 


dec 


a 


; 5 


t 


states 


Id 


a,l 


; k 


t 


states 


cr 


h 


; k 


t 


states 


JP 


nz,lccp 


;10 


t 


states 


pop 


de 


;10 


t 


states 


dec 


de 


; 6 


t 


states 


Id 


a,e 


; 4. 


t 


states 


cr 


d 


; k 


t 


states 


JP 


nz,cloop 


;10 


t 


states 


ret 











shcrtdelay - 10 micro second delay 
entry : none 
exit : none 

notes: this subroutine should take at least 10 microseconds 
to return, it is a one shot deal. 

registers a, d, e, h, and 1 are changed 



shcrtdelay: 

Id 

dec 

ret 



hl,0 
a 



10 t states 
5 t states 
10 t states 



pin - get the state of a particular pin 

entry: parameter # 1 - prom port select (0 - 15) 

exit: return the input value from the port 



pin: 


call 


parml 






Id 


a,e 


;pcrt select in a 




push 


be 


;save be 




call 


apin 


; input it 
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pep be ;restcre be 

Id h,0 ;zerc upper byte 

Id l,a »get return value 

or a ;set the zero flag 

ret 

; apin - get the state cf a particular pin (does not interface to C) 

; entry: register a - prcm pert select (0 - 15) 

; exit: return one input value from the pert in register hi 

apin: and 7fh ;make sure direction bit is input 

Id b,a ;save in b 

Id a,0cfh ;make syspic port b input 

cut (cbsys),a 

Id a,0ffh 

cut (cbsys),a 

Id a,b 

cut (dbpar),a jcutput the address to parpio 

in a,(dbsys) ; input the data 

ret 

; pout - output data to the hardware 

; entry: parameter # 1 - prom port select (0 - 22) 

; parameter # 2 - pin manipulation mask 

; exit : none 

pcut: call parml 

Id a,e ;port select in a 

inc hi 

inc hi 

Id e,(hl) ;pin manipulation mask in e 

push be ;save be 

call apcut ; input it 

pop be ; restore be 

ret 

; apcut - output data to the hardware (does not interface be C) 

; entry: register a - prcm port select (0 - 22) 

; register d - pin manipulation mask 
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exit: none 



apcut : 



or 

Id 

Id 

cut 

Id 

cut 

Id 

cut 

ret 



80h 
b,a 
a,0fh 
(cbsys) ,a 
a,b 

(dbpar) ,a 
a,e 

(dbsys) ,a 



;set directicn bit tc cutput 

;put the results in b, the 

jmake sure syspic pert b is cutput 



; cutput pert select ' 
;put the pin mask in a 



pump - pump a stream cf data bytes tc the parellel interface 
entry: parameter # 1 -address cf byte stream 
exit : ncne 



notes: 



The format cf the byte stream is as fellows: 

glength g number of bytes in byte stream 

g addr g high order bit must be set in address 

g data g data tc be written tc cmni register 

g addr g address and data bytes always in pairs 

g data g 

g addr g 

g data g 



pump: call parml 

inc hi 

id h, (hi) ;get the pointer into hi 

Id l,e 

push be jsave be for aztec c 

Id b,(hl) ;get the byte count 

inc hi jpcint tc first byte 

Id a,0fh ;make sure syspio port b is cutput 

cut (cbsys), a 

; this cede outputs an address and data pair to the omni-prcgrammer 
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pair: Id c,dbpar ; address port 

outi 

Id c,dbsys ;data port 

outi 

jp nz,pair jkeep going 



return to aztec c 



pep be 
ret 



parml - get the first parameter off of the stack 
entry: none 

exit: low byte of parameter in register e 



parml: Id hi, k Jget the parameter off of the stack 

add hl,sp jwithcut desturbing the stack 

Id e,(hl) ;prarmeter byte in e 

ret 

end 
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CUSTOMER PROBLEM REPORT 
HARDWARE Please Identify Type or Model Listed Below: 

o Chip Handler o GP1H0 o Socket Adaptor 

c IBM-PC Card c SP0300 o Cable 

o Kaypro II 
SOFTWARE Please Identify Source: 

c License Device Group # Version 

o Omni Comm 

o MMI PALASM 

c Kaypro (Varix does not warrant nor maintain third 
party software) 

Date: Reported by 

Description of Problem: 



Example Sequence for Recreating Problem: 



Resolution: 



Varix Contact: 



CUSTOMER RESPONSE FORM 



Your comments help us improve the quality and usefullness of cur 
publications. Please use this form for questions or comments 
about this publication. If your answer to a question is "no" or 
requires additional comments, please explain in the space provided 
below. Give specific page and line references when appropriate. 

If you wish a reply, be sure to include your name and address. 

Comments and suggestions become the property of Varix Corporation. 



Yes No 

Is the Manual well organized? 

Is the Manual easy to read and 

understand? 

Is the Manual complete? 

Is the Manual written for your 

technical level? 



Comments: 



Thank you for your cooperation. 
Please mail the completed form to: 



Varix Corporation 

122 Spanish Village #608 

Dallas, TX 75248 USA 
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